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Overview 


About This Manual 


The DYNIX/ptx Reference Manual is for programmers working in the 
DYNIX/ptx operating system environment. This manual describes the 
programming features of the operating system and assumes that the 
audience is familiar with the operating system. It does not provide a general 
overview of the operating system or implementation details of the system. 


Organization 


The DYNIX/ptx Reference Manual is contained in five binders organized as 


follows: 
¢ Section 1 A-F 


¢ Section 1 G-Z 


Commands 


Commands 


¢ Section 2 System Calls 

Section 2SEQ Sequent System Calls 

Section 3 Subroutines 
Section 3C C Library Routines 
Section 3M Mathematical Library Routines 
Section 3N Networking Support Utilities 
Section 3PPS Sequent Parallel Programming Library 
Section 3S Standard I/O Library Routines 
Section 3SEQ Sequent I/O Library Routines 
Section 3X Special Routines 


¢ Section 4 
Section 5 


¢ Section 7 
Section 8 


File Formats 
Miscellaneous Facilities 


Special Files 
Stand-alone Utilities 
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@ 
Each binder also contains the following items: 


¢ Table of Contents that alphabetically lists the contents of the entire 
manual set 


¢ Permuted Index that lists each programming feature in the entire 
manual set 


The permuted index is a list of keywords, given alphabetically in the second 
of three columns, together with the context in which each keyword is found. 
The following shows four separate entries illustrating four ways that the cat 
command can be looked up in the permuted index. Note that you can find the 
cat command by looking up “cat,” “concatenate,” “files,” or “print.” 


cat: concatenate and print files........... cat (1) 

cat: concatenate and print files.........50.0.% cat (1) 

concatenate and prin€ flleS cia cscs seisnieaies 632 6s seieawieweiss sod cat (1) 
Goncatenate and = PELNt Pies ace é:c: siaissacasssarya io daca epniecacoiaiscays 9 0 410 cat (1) 


Keywords are either topical keywords or the names of manual entries 

themselves. Entries are identified with their section numbers shown in 

parentheses. The numbers are important because there is duplication of 

names among the sections. The right column lists the name of the manual @ 
page on which each keyword may be found. The left column contains useful 

information about the keyword. 


The following paragraphs briefly describe the other sections of the manual. 


Section 1: Commands describes operating system commands and 
commands that support C and other programming languages. 


Section 2: System Calls describes the access to the services provided by the 
operating system kernel, including the C language interface. 


Section 2SEQ: Sequent System Calls describes the access to the Sequent 
services provided by the operating system kernel, including the C language 
interface. 


Section 3: Subroutines describes the available subroutines. Their binary 
versions reside in various system libraries in the directories /lib and 
/usr/lib. The introduction to Section 3 describes these libraries and the files 


in which they are stored. & 
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Section 4: File Formats documents the structure of particular kinds of 
files; for example, the format of the output of the link editor is given in 
a.out(4). Excluded are files used by only one command (for example, the 
assembler’s intermediate files). In general, the C language structures 
corresponding to these formats can be found in the directories /usr/include 
and /usr/include/sys. 


Section 5: Miscellaneous Facilities contains a variety of descriptions 
including descriptions of character sets, macro packages, and so forth. 


Section 7: Special Files describes various special files that refer to specific 
hardware peripherals and operating system device drivers. 


Section 8: Stand-alone Utilities describes stand-alone procedures. 


References to manual pages with numbers other than those above mean that 
the utility is contained in the appropriate section of another manual. Each 
section consists of independent entries which are alphabetized, with the 
exception of the introductions that begin some sections. Section 3 is divided 
into subsections in alphabetical order by suffix. Some entries may describe 
several routines, commands, and so forth. In such cases, the entry appears 
only once, alphabetized under its primary name, the name that appears at 
the upper corners of each manual page. 


Each manual page can be viewed online with the man(1) command. For 
example, enter man shell to view the shell manual page. Enter man man 
for more information about the man command. 


Notational Conventions 


Manual pages are based on a common format. The main headings are 
described here—not all of them appear in all cases: 


¢ NAME gives the name(s) of the entry and briefly states its purpose. 
This entry is used to create the Permuted Index and the Table of 
Contents. 


¢ SYNOPSIS summarizes the usage of the program being described. 
Conventions vary in some sections but are generally as follows: 
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¢ Boldface strings are literals and are to be typed just as they 
appear. 


¢ Italic strings usually represent substitutable argument prototypes 
and program names found elsewhere in the manual. 


¢ Square brackets [] around an argument prototype indicate that 
the argument is optional. When an argument prototype is given 
as name or file, it refers to a filename. 


e Ellipses ... are used to show that the previous argument 
prototype may be repeated. 


¢ A final convention is used by the commands themselves. An 
argument beginning with a minus -, plus +, or equal sign = is often 
taken to be some sort of flag argument even if it appears in a 
position where a file name could appear. Therefore, it is unwise to 
have files whose names begin with -, +, or =. 


* CONFIGURATION ENTRY shows how a driver is called out in a system 
configuration file. 


¢ DESCRIPTION describes the entry, including its purpose and how it is 
used. 


¢ FIELDS describe system file or record entries. 
¢ EXAMPLES and BINARY CONFIGURATION give examples of usage. 


¢ FILES list files that are part of a program, created by a program, or 
related to a program. 


¢ SEE ALSO points to related information in other manual pages. 


¢ DIAGNOSTICS discuss the diagnostic (error) messages that may be 
produced. Messages that are self-explanatory are not listed. 


¢ WARNINGS contains warnings against improper user actions. 
¢ NOTES give hints about the use of the utility. 


¢ BUGS describe known bugs in the software. 
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Contents. 


1 Commands 


DEHOCD) -scscssssssieaccsssosstessisiecsasessescasatneencanaw introduction to maintenance commands and 
application programs 

... handle special functions of DASI 300 and 300s terminals 
. paginator for the Tektronix 4014 terminal 

. handle special functions of the DASI 450 terminal 

. allow or prevent LP requests 


300(1): 300, 300s . 
4014(1) 
450(1) .... 
accept(1M): accept, reject . 
acct(1M): acctdisk, acctdusg, accton, 


ACCLWLINP  secsesssssssssessenensersnsesessssosesenssanens overview of accounting and miscellaneous 

accounting commands 
acctems(1M) . . command summary from per-process accounting records 
acctcom(1) .... . search and print process accounting files 


. connect-time accounting 
. merge or add total accounting files 
. process accounting 


acctcon(1M): acctcon1, acctcon2 . 
acctmerg(1M) .. 
acctpre(1M): acctprel, acctpre2 
acctsh(1M): chargefee, ckpacct, 
dodisk, lastlogin, monacct, 

nulladm, pretmp, prdaily, prtacct, 
shutacct, startup, turnacct . 
addcmdopt(1M) 
addformopt(1M) 


.. Shell procedures for accounting 
add a command option to a menu 
add a form/SELECT window option to a menu 


addmenuopt(1M) add a menu option to a menu 

admin(1) .. create and administer SCCS files 

apropos(1) . locate commands by keyword lookup 

ar(1) .... see C and Language Tools Binder 

as(1) .... see C and Language Tools Binder 

asa(1) interpret ASA carriage control characters 
assist(1) assistance using operating system commands 


.« Program for generating/modifying ASSIST menus or 
command forms 

.. execute commands at a later time 

pattern scanning and processing language 

make posters 

deliver portions of pathnames 


astgen(1) 


at(1): at, batch 
awk(1) .... 
banner(1) .. 
basename(1): basename, dirname 


De(1) sevens doessaens arbitrary-precision arithmetic language 
beheckre(1M) system initialization procedures 
bdflush(1M) update daemon 

bdiff(1) big diff 


bfs(1) ... big file scanner 

bomverify(1M) . .. perform an installation consistency check based on 
the BOM 

bootflags(1M) display/change system boot flags 

bp(1M) binary patcher 

cal(1) ... .. print calendar 
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.. reminder service 
convert a termcap description into a terminfo description 


calendar(1) 
captoinfo(1M) . 


cat(1) concatenate and print files 
cb(1) see C and Language Tools Binder 
ec(1) see C and Language Tools Binder 


cd(1) .. change working directory 


ede(1) change the delta commentary of an SCCS delta 
cflow(1) . see C and Language Tools Binder 
checkeq(1) check documents for correct eqn syntax. 


checkfsys(1M) . 
chmod(1) 
chown(1): chown, chgrp .. 
chroot(1M) .. 
chrtbl(1M) 


check a filesystem 

.. change mode 

.. change owner or group 

change root directory for a command 

generate character classification and conversion tables 
check in RCS revisions 

check filesystem backup schedule 


clri(1M) clear inode 
emp(1) compare two files 
co(1) .. check out RCS revisions 


filter reverse line-feeds 
combine SCCS deltas 
.. select or reject lines common to two sorted files 


col(1) .. 
comb(1) . 

comm(]) ... 
compress(1): compress, 
uncompress, zcat 
config(1M) 
coproc(1F): cocreate, cosend, 
cocheck, coreceive, codestroy 
cp(1): cp, ln, mv . 


.. compress and expand data 
.. build system configuration files 


.. communicate to a process 
copy, link or move files 


cpp(1) .... see C and Language Tools Binder 

cpio(1) copy file archives in and out 

cprs(1) see C and Language Tools Binder 

cpset(1) .. copy file and set mode, user, and group IDs 


crash(1M) . 
cron(1M) ... 
crontab(1) 
crypt(1) . 


examine system images 
clock daemon 

user crontab file 
encode/decode 


esh(1) . .- a shell (command interpreter) with C-like syntax 
esplit(1) . .. context split 
ct(1C) . .. spawn getty to a remote terminal 


ctags(1) .. 
ctrace(1) 
cu(1C) 

cut(1) .. 


.. create a tags file 

.. see C and Language Tools Binder 

.. call another UNIX system 

.. cut out selected fields of each line of a file 


exref(1) .. see C and Language Tools Binder 
date(1) ... .. print and set the date 

dbx(1) .. see C and Language Tools Binder 
dc(1) ... desk calculator 

dcheck(1M) filesystem directory consistency check 


dd(1M) ... 
delta(1) .. 


convert and copy a file 
.. make a delta (change) to an SCCS file 
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eKON CL): sesssscsnsssacescessesssensssensavsoccusniateessve remove nroff, tbl, and eqn constructs 
devbuild(1M): devbuild, 
devdestroy . . build and destroy virtual devices 


devnm(1M) . . device name 

df{1M) . . Teport number of free disk blocks and inodes 
aiff{1) .. . differential file comparison 

diff3(1) . 3-way differential file comparison 

diremp(1) . directory comparison 

dis(1) ....... . see C and Language Tools Binder 
diskusg(1M) . generate disk accounting data by user ID 
dltsectbl(1M) . refresh security table 

dmesg(1M) . . collect system diagnostic messages to form error log 
du(1M) .... . summarize disk usage 

dump(1) .. . see C and Language Tools Binder 

dump(1M) .. . incremental filesystem dump 
dumpconf{1M) .. .. dump kernel auto-configuration device table 
dumpfs(1M) . dump filesystem information 

ec(1M) .. . forms compiler 

echo(1) . . echo arguments 

echo(1F) .. . put string on virtual output 

ed(1): ed, red . text editor 

edc(1M) .. . Tun an externally described command 
edit(1) .. . text editor (variant of ex for casual users) 
edquota( . edit user quotas 

efl(1) .... . Extended Fortran Language 

egrep(1) . search a file for a pattern using full regular expressions 
enable(1): enable, disable . enable/disable LP printers 

env(1) .. . set environment for command execution 
ex(1) . . text editor 

expr(1) . . evaluate arguments as an expression 
factor(1) . obtain the prime factors of a number 

(1M) ... . list filenames and statistics for a filesystem 
fgrep(1) search a file for a character string 

file(1) ....... determine file type 

AQT) -cerseracs find files 

format(1M) ... format disks or perform other defect management 


functions 
fsck(1M)  ceesessssssseeee .... filesystem consistency check and interactive repair 


fsirand(1M) install random inode generation numbers 
fsplit(1) .... split {77, ratfor, or efi files 

festat(1M) report filesystem status 

fstyp(1M) . determine filesystem identifier 

fuser(1M) identify processes using a file or file structure 


fwtmp(1M): fwtmp, wtmpfix . 
gdev(1G): hpd, erase, hardcopy, 


manipulate connect accounting records 


tekset, td . .. graphical device routines and filters 
ged(1G) ..... graphical editor 
gence(1M) create a front-end to the cc command 


get a version of an SCCS file 
.. returns the current frame number 
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getitems(1F) .. returns a list of the currently marked menu items 
getopt(1) ...... parse command options 

getopts(1): getopts, getoptcvt parse command options 

getty(1M) set terminal type, modes, speed, and line discipline 


.. definitions of common operating system terms and 
symbols 
QTAPH(1G) ..eressccssssssccscsscscsessessensessererssees draw a graph 


glossary(1) .. 


graphics(1G) .. access graphical and numerical commands 

greek(1) .... select terminal filter 

grep(1) .. search a file for a pattern 

groups(1) .. show group memberships 

gutil(1G) .. graphical utilities 

help(1) ...... operating system Help Facility 

helpadm(1M) change the Help Facility database 

hp(l) . ... handle special functions of Hewlett-Packard terminals 

hpio(1) .. .. Hewlett-Packard 2645A terminal tape file archiver 

icheck(1M) filesystem storage consistency check 

id(1M) ... print user and group IDs and names 

ident(1) .... identify files 

indicator(1F) .. display application specific alarms and/or the 
working indicator 

infocmp(1M) . .. compare or print out terminfo descriptions 

init(1M): init, telinit process control initialization 

install(1M) ...... install commands 

installboot(1M) installs a boot program on a disk 


.. remove a message queue, semaphore set, or shared 
memory ID 

Tpcs(1) seven .. report inter-process communication facilities status 

isismgr(1M) ISIS file manager, updates text files in ISIS file format 

join(1) ....... relational database operator 

kill(1) .... terminate a process 

killall(1M) ... kill all active processes 

ksh(1): ksh, rksh.. .. the KornShell, a standard/restricted command and 


UPCrM(1) sessessereeens 


programming language 
labelit(1M) .. provide labels for filesystems 
1d(1) .. see C and Language Tools Binder 


lex(1) generate programs for simple lexical tasks 


line(1) read one line 

link(1M): link and unlink files and directories 

lint(1) ... see C and Language Tools Binder 

list(1) .... see C and Language Tools Binder 

locate(1) use keywords to identify an operating system command 
login(1) . sign on 

logname(1) get login name 

lorder(1) ...... see C and Language Tools Binder 


Ip(1): Ip, cancel 
Ipadmin(1M) ... 
Ipfilter(1M) ... 
Ipforms(1M) . 


send/cancel requests to the LP print service 
configure the LP print service 

administer filters used with the LP print service 
.. administer forms used with the LP print service 
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Ipsched(1M): lpsched, Ipshut, 
Ipmove ... 
Ipstat(1) 
Ipusers(1M) . 
1s(1) 00s 
m4(1) . 
machid(1): i386, ns32000, pdp11, 

u3b, u3b2, u3bb, vax... . get processor type truth value 

mail(1): mail, rmail . send mail to users or read mail 

mailbug(]) «ss . submit a bug report or enhancement request 


. start/stop the LP print service and move requests 

. print information about the status of the LP print service 
. set printing queue priorities 

. list contents of directory 

. macro processor 


mailx(1) . interactive message processing system 
make(1) . maintain, update, and regenerate groups of programs 
makealiases(1M): makealiases, 

makewhatis .... generate man page databases 
makedev(1M) . make system special files 

makekey(1) .. generate encryption key 

man(1) ... .. display on-line man pages 

mes(1) .... . manipulate the object file comment section 
menu(1M) .. Menu processor 

menumsg(1M) ... Toute user message to menu message queue 
merge(1) ... . three-way file merge 

mesg(1) ..... . permit or deny messages 

message(1F) . . puts its arguments on message line 
mkdir(1) ... . make directories 

mkfs(1M) .. . construct a filesystem 

mknod(1M) . . build special file 

mkpwdbm(1M) . make a database for fast password lookup 
mkvtoc(1M) .. . populate VTOC on disks 

monitor(1M) . monitor system activity 

more(1) ..... . view a file one full screen at a time 


mount(1M): mount, umount . 
mountall(1M): mountall, 
umountall . 
mt(1) 
mvdir{1M) . 
- nawk(1) 
ncheck(1M) 
newform(1) .. 
newfs(1M) ..... 


. mount and unmount filesystems 


. mount, unmount multiple filesystems 
magnetic tape manipulating program 

.. Move a directory 

pattern scanning and processing language 
generate pathnames from i-numbers 
change the format of a text file 

construct a new file system 


newgrp(1M) . log in to a new group 

news(1) print news items 

nice(1) . .. Tun a command at low priority 
ni(1) . line numbering filter 


nm(1) .. .. 8ee C and Language Tools Binder 

noage(1M): noage, nopff, noswap, 

OMPTOC sesesssssssersseesessssenensaceesrenscnconsesanseere run a command with priority aging, PFF, swapping, 
or processor migration disabled 

nohup(1) .. run a command immune to hangups and quits 

od(1) .... octal dump 


online(1M): online, offline .. ... bring processors online and offline 
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pack(1): pack, pcat, unpack 
passmgmt(1M) . 
passwd(1) ....... 
paste(1) 


compress and expand files 

password files management 

change login password and password attributes 
merge same lines of several files or subsequent lines 
of one file 

search Interpreter criteria for filename 

see C and Language Tools Binder 

file perusal filter for CRTs 

display or alter parameters of virtual-to-physical 
mapping devices 

. print files 

display profile data 

... Prompt program 

.. print an SCCS file 

print the VTOC of a block device 

.. Teport process status 

password/group file checkers 

installs and updates /etc/shadow with information 
from /etc/passwd 


pathconv(1F) . 


prof(1) 
prompt(1M) . 
prs(1) . 
prtvtoc(1M) . 
ps(1) 
pwck(1M): pwck, grpck 
pwconv( 1M) 


pwd(1) . working directory name 

pwdhd(1M) daemon to oversee password database creation 
pwfix(1M) .... remove incorrectly formatted password entries 
pwunconv(1M) converts from a two to a one password file scheme 
quota(1) . display disk usage and limits 


... filesystem quota consistency checker 

turn filesystem quotas on and off 

rational Fortran dialect 

run commands performed to stop the operating system 
... run commands performed for multi-user environment 
.. change RCS file attributes 

compare RCS revisions 


quotacheck(1M) 
quotaon(1M): quotaon, quotaoff 
ratfor(1) 
rc0(1M) 


resintro(1) .. introduction to RCS commands 
resmerge(1) .. Merge RCS revisions 
readfile(1F): readfile, longline reads file and gets longest line 


regular expression compile 
match patterns against a string 


regemp(1) .... 
regex(1F) .. 


reinit(1F) . run an initialization file 

repquota(1M) summarize quotas for a filesystem 

reset(1F) ... reset the current form field to its default values 
restore(1M) . .. incremental filesystem restore 

rlog(1) .. print log messages and other information about RCS files 


remove files or directories 
remove a delta from an SCCS file 
remove a menu option 

.. Tun an executable 


rm(1): rm, rmdir . 
rmdel(1) ... 
rmvopt(1M) . 
run(1F) 


runacct(1M) .. run daily accounting 

sact(1) .... print current SCCS file editing activity 
sag(1G) ... . system activity graph 

sar(1) . system activity reporter 


sar(1M): sal, sa2, sade . system activity report package 
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savecore(1M) .. .. Save a core dump of the operating system 

seesdiff(1) ..... . compare two versions of an SCCS file 

sccstorcsa(1) . build RCS file from SCCS file 

sdiff(1) . side-by-side difference program 

sed(1) . . stream editor 

set(1F): set, unset . set and unset environment variables in core or in files 


setcolor(1F) .. . redefine or create a color 

setmnt(1M) . establish mount table 

setpgrp(1) . . Tun command in its own process group 
setup(1) .... . initialize system for first user 


. shell, the standard/restricted command 
programming language 

BHENCLE) . sessiscnssvesasssessssesnsenenn ««. Tun a command using shell 

showcfg(1M) .... . show the configuration of the machine 

shutdown(1M) . shut down system, change system state 

size(1) .. see C and Language Tools Binder 

sleep(1) .. ... suspend execution for an interval 

sort(1) .... .. sort and/or merge files 

spell(1): spell, hashmake, spellin, 

hashcheck . 


sh(1): sh, rsh.... 


find spelling errors 


spline(1G) . interpolate smooth curve 

split(1) ... split a file into pieces 

starter(1) .. information about the operating system for 
beginning users 

stat(1G) statistical network useful with graphical commands 


strace(1M) . print STREAMS trace messages 
strclean(1M) STREAMS error logger cleanup program 
strerr(1M) . STREAMS error logger daemon 

strip(1) .. see C and Language Tools Binder 
stty(1) .. set the options for a terminal 


su(1M) 


sum(1) ... 


become superuser or another user 
print checksum and block count of a file 


SWAP(1M)  wrecceseseeerees swap administrative interface 
sweepon(1M): sweepon, sweepoff enable/disable patrol seeks on DCC disks 
sync(1M) .. update the superblock 


sysadm(1) .. 
tabs(1) 
tail(1) .. 


.. menu interface to do system administration 
set tabs on a terminal 
.. deliver the last part of a file 


tar(1) .. .. tape file archiver 

tasktbl(1M) create security table in shared memory 
tee(1) ... .. Pipe fitting 

test(1) . .. condition evaluation command 
tfipe(1M) . interprocess communication reporter 
tfmenush(1M) assign menu system as user login shell 
tfnotify(1M) send completion message 

tic(1M) .....s.s0e terminfo compiler 


time a command 

time a command; report process data and system activity 
graphical table of contents routines 

.. update access and modification times of a file 


time(1): time, ptime . 
timex(1) .. 
toc(1G): dtoc, ttoc, vtoc 
touch(1) 


DYNIX/ptx Reference Manual 7 


Contents 


graphics filters 

initialize a terminal or query terminfo database 
.. translate characters 

. provide truth values 

topological sort 


tplot(1G) 
tput(1) 
tr(1) 
true(1): true, false 
tsort(1) 


tty(1) .. get the name of the terminal 
ttydevname(1) .. get the device associated with a terminal or the 
terminal associated with a device 
tunefs(1M) .. tune up an existing filesystem 
uadmin(1M) administrative control 
umask(1) . set file-creation mode mask 
uname(1) . . print name of current system 
unget(1) undo a previous get of an SCCS file 
uniq(1) .. report repeated lines in a file 
units(1) . conversion program 
uptime(1) show how long system has been up 


usage(1) retrieve a command description and usage examples 
8 P. 


uucheck(1M) check the uucp directories and permissions file 
uucico(1M) .. ... file transport program for the uucp system 
uucleanup(1M) . .. uuep spool directory clean-up 

uucp(1C): uucp, uulog, uuname UNIX-to-UNIX system copy 

uugetty(1M) set terminal type, modes, speed, and line discipline 
uusched(1M) the scheduler for the uucp file transport program 
uustat(1C) ... uuep status inquiry and job control 

uuto(1C); uuto, uupick . public UNIX-to-UNIX system file copy 

uutry(1M) try to contact remote system with debugging on 
uux(1C) .., .. UNIX-to-UNIX system command execution 
uuxqt(1M) .. execute remote command requests 

val(1) . validate SCCS file 

ve(1) version contro] 

vi(1) ... screen-oriented (visual) display editor based on ex 
yvmtune(1M) .. tune system-wide virtual-memory parameters 
volcopy(1M) . make literal copy of filesystem 

vsig(1F) synchronize a co-process with the controlling FMLI object 
wait(1) .. .. await completion of process 

wall(1) .. write to al] users 

we(1) .. word count 

what(1) . identify SCCS files 

whatis(1) describe what a command is 

who(1) ... .. who is on the system 

whodo(1M) .. Who is doing what 

write(1) write to another user 

xargs(1) .. construct argument list(s) and execute command 
yace(1) yet another compiler-compiler 


8 . DYNIX] ptx Reference Manual 


Contents 


2 System Calls 


intro(2) .... .. introduction to system calls and error numbers 
access(2) .. determine accessibility of a file 

acct(2) .... .. enable or disable process accounting 

alarm(2) .. .. set a process alarm clock 


brk(2): brk, sbrk . .. change data segment space allocation 
Chdir(2) wreseeeee .. change working directory 


chmod(2) . .. change mode of file 

chown(2) .. .. change owner and group of a file 

chroot(2) .. .. Change root directory 

close(2) . .. Close a file descriptor 

creat(2) . .. create a new file or rewrite an existing one 
dup(2) ... .. duplicate an open file descriptor 


GUP22) szesassacccacenccesecresecevessoserassatecceratees duplicate an open file descriptor 
exec(2): execl, execv, execle, 

execve, execlp, execvp 
exit(2): exit, exit 
fentl(2) .. 


.. execute a file 
terminate process 
file contro] 


fork(2) ... create a new process 

getdents(2) .. . read directory entries and put ina file system 
independent format 

getgroups(2) .. get supplementary group IDs 

getmsg(2) . .. get next message off a stream 


getpid(2): getpid, getpgrp, getppid .... get process, process group, and parent process IDs 


getuid(2): getuid, geteuid, getgid, 


BOLO TIG  saccssserosersssssenssssossossveze Sestnadesnssens » get real user, effective user, real group, and effective 
group IDs 
joctl(2) .. . contro] device 


. send a signal to a process or a group of processes 
link to a file 

. move read/write file pointer 

. make a directory 

. make a directory, or a special or ordinary file 

. mount a filesystem 


kill(2) .... 
link(2) ... 
Iseek(2) . 
mkdir{2) ... 
mknod(2): mknod . 
mount(2) .. 


msgcetl(2) . message control operations 
msgget(2) . . get message queue 
msgop(2) . message operations 


nice(2) .... . change priority of a process 


open(2) . . open for reading or writing 
pathcon{{2): pathconf, fpathconf . get configurable pathname variables 
pause(2) . . suspend process until signal 

pipe(2) . create an interprocess channel 


. lock process, text, or data in memory 


plock(2) . 
. STREAMS input/output multiplexing 


poll(2) 


profil(2) . . execution time profile 
ptrace(2): ptrace, mptrace . process trace facility 
putmsg(2) . send a message on a stream 
read(2) ... . read from file 

rename(2) . change the name of a file 
rmdir(2) .... . remove a directory 
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semctl(2) .... 
semget(2) .... 


.. semaphore control operations 
.. get set of semaphores 
.. semaphore operations 


setpgid(2) manipulate signal sets 

setpgrp(2) set process group ID 

setsid(2) create session and set process group ID 
setuid(2): setuid, set user and group IDs 


shmctl(2) .... shared memory control operations 


shmget(2) ... get shared memory segment identifier 
shmop(2): shmop, 8 shared memory operations 
sigaction(2) .. examine and change signal actions 


sigemptyset(2): sigemptyset, 
sigfillset, sigaddset, sigdelset, 
sigismember .. 
signal(2) 
sigpending(2) ..... 
sigprocmask(2) . 
sigset(2): sigset, sighold, sigrelse, 
sigignore, sigpause . 
sigsuspend(2) 
stat(2): stat, Istat, fstat 
statfs(2): statfs, fstatfs . 


.. manipulate signal sets 

.. specify what to do upon receipt of a signal 
.. examine pending signals 

.. examine and change blocked signals 


. signal management 

wait for a signal 

. get file status 

.. get filesystem information 


stime(2). seecssesesses mis set time 

stty(2): stty, gtty . set and get terminal state (defunct) 
sync(2) . update superblock 

syscall(2) .. indirect system call 

sysconf{(2) ... get configurable system variables 
sysi86(2) .. machine specific functions 
tegetattr(2): tcgetattr, tcsetattr get/set terminal state 

tegetpgrp(2) ... get foreground process group ID 
tesetpgrp(2) set foreground process group ID 
time(2) ..... get time 

times(2) .. get process and child process times 
uadmin(2) .. administrative control 

ulimit(2) .. .. get and set user limits 

umask(2) . .. set and get file creation mask 
umount(2) .., .. unmount a filesystem 

uname(2) .... . get name of current operating system 
unlink(2) . remove directory entry 

ustat(2) .... .. get filesystem statistics 

utime(2) ... .. set file access and modification times 
vfork(2) .. Spawn new process in a virtual memory efficient way 
wait(2): wait, waitpid .. Wait for a child process to stop or terminate 
SHTTCO(Z) csceiedcoviasscaussssasevessevavsieesssessssscscs write on a file 
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2SEQ Sequent System Calls 


intro(2SEQ) .. Introduction to Sequent system calls 
bdflush(2SEQ) update daemon 

fvhangup(2SEQ) ... .. Virtually hangup the specified controlling terminal 
get_process_stats(2SEQ) .. get resource utilization information 
getdtablemax(2SEQ) ... .. get maximum in-use descriptor table index 
getdtablesize(2SEQ) .... .. get descriptor table size 

getpagesize(2SEQ) .. get system page size 

mmap(2SEQ) ..... .. Map an open file into the processs address space 
munmap(2SEQ) .. unmap part of the processs address space 


proc_ctl(2SEQ) .. 
quotactl(2SEQ) .. 


.. control over various process attributes 
.. Manipulate disk quotas 


readlink(2SEQ) . .. read value of a symbolic link 
readv(2SEQ) .....00 .. read vector from file 
setdtablesize(2SEQ) .. set descriptor table size 
setgroups(2SEQ) .. .. set group access list 
sigcontext(2SEQ) . .. get signal context 

sigstack(2SEQ) .. .. set and/or get signal stack context 


make symbolic link to a file 
bind a process to a processor 
.. multi-processor control 


symlink(2SEQ) ... 
tmp_affinity(2SEQ) . 
tmp_ctl(2SEQ) 
truncate(2SEQ): truncate, 


ftruncate ..... .. truncate a file to a specified length 
vm_ctl(2SEQ) .. examine and change virtual memory tuning parameters 
writev(2SEQ) .. write vector on a file 


3 Subroutines 


intro(3) . .. introduction to functions and libraries 


3C C Library Routines 


a641(3C): a641, 164a .. convert between long integer and base-64 ASCII string 


abort(3(C) ..... .. generate an IOT fault 
abs(3C) ..... return integer absolute value 
bsearch(3C) . binary search a sorted table 
clock(3C) . .. report CPU time used 


conv(3C): toupper, tolower, 
_toupper, _tolower, toascii 
crypt(3C): crypt, setkey, encrypt 
ctime(3C): ctime, localtime, 
gmtime, asctime, cftime, ascftime, 

mktime, tZ8et ....cssserseereers ocaainanacsaccustns convert date and time to string 
ctype(3C): isdigit, isxdigit, 

islower, isupper, isalpha, isalnum, 

isspace, iscntrl, ispunct, isprint, 

isgraph, isascii, tolower, toupper, 

toascci, tolower, _toupper, 

SCtCHYC]ASS vesscessssessssecsssscnrensenearenssessesscee character handling 


.. translate characters 
.. generate hashing encryption 
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dev_to_ttyname(3C): dev_to_ttyname, 

ttyname_to_dev ... .. convert between major/minor numbers and tty names 
dial(3C) .. establish an out-going terminal line connection 
drand48(3C): drand48, erand48, 
lrand48, nrand48, mrand48, 
jrand48, srand48, seed48, lcong48 
ecvt(3C): ecvt, fevt, gcvt ..... 
end(3C): end, etext, edata . 
fpgetround(3C): fpgetround, 
fpsetround, fpgetmask, fpsetmask, 
fpgetsticky, fpsetsticky 
frexp(3C): frexp, ldexp, modf . 
ftw(3C) ...... 
getewd(3C) 
getenv(3C) 
getgrent(3C): getgrent, getgrgid, 
getgrnam, setgrent, endgrent, 


generate uniformly distributed pseudorandom numbers 
convert floating-point number to string 
.. last locations in program 


.. IEEE floating-point environment control 
manipulate parts of floating-point numbers 
walk a file tree 

get pathname of current working directory 
.. return value for environment name 


fgetgrent ... .. get group file entry 

getlogin(3C) get login name 

getopt(3C) . get option letter from argument vector 
getpass(3C) read a password 

getpw(3C) .. get name from UID 


getpwent(3C): getpwent, 

getpwuid, getpwnam, setpwent, 

endpwent, fgetpwent ........ isiaemvasatensasses get password file entry 
getut(3C): getutent, getutid, 

getutline, pututline, setutent, 


endutent, utmpname, getutpid .......0.0 access utmp file entry 
hsearch(3C): hsearch, hcreate, 
hdestroy sssssssseees sige sineoxsedaceoniacue ienassciae manage hash search tables 


.. test for floating-point NaN (Not-A-Number) 
convert between 3-byte integers and long integers 


isnan(3C): isnand, isnanf 
13tol(3C): 13tol, Itol3 . 


lock (BC) ...scsessrerseeee record locking on files 
Isearch(3C): Isearch, Ifind .....seseee linear search and update 
malloc(3C): malloc, free, realloc, 

calloc main memory allocator 


memory(3C): memccpy, memchr, 

memcmp, memcpy, memset . ... memory operations 
mkfifo(3C) ..... make a FIFO special file 
mktemp(3C) make a unique filename 
monitor(3C) prepare execution profile 
nlist(3C) .... .. get entries from name list 
perror(3C): perror, errno, 

sys_errlist, sys_nerr .. 
putenv(3C) .... 
putpwent(3C) 
QBOFt(3C)  wreseesees 
rand(3C): rand, srand simple random-number generator 
setjmp(3C): setjmp, longjmp . .. non-local goto 

Betlocale(BC) ....s.scssssssssssessssersesesseessses set programs location 


.. System error messages 

change or add value to environment 
.. write password file entry 

.. Quicker sort 
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sigsetjmp(3C): sigsetjmp, 
siglongjmp .. 
sleep(3C) 
ssignal(3C): ssignal, gsignal 
stdipc(3C) ..... 
strftime(3C) 
string(3C): strcat, strdup, strncat, 
strcmp, strncmp, strepy, strncepy, 
strlen, strchr, strrehr, strpbrk, 
strspn, strespn, strtok . 
Strstr(3C)  ..rscseseeeeeeees 
strtod(3C): strtod, atof 
strtol(3C): strtol, atol, atoi 
swab(3C) 
tsearch(3C): tsearch, tfind, 
tdelete, twalk ..... 
ttyname(3C): ttyname, isatty . 
ttyslot(3C) 


.. non-local jumps 

.. suspend execution for interval 

.. software signals 

.. 8tandard interprocess communication package 
.. format time information 


. string operations 

find first occurrence of character 

convert string to double-precision number 
convert string to integer 

.. Bwap bytes 


.. manage binary search trees 
.. find name of a terminal 
.. find the slot in the utmp file of the current user 


3M Mathematical Library Routines 


bessel(3M): j0, jl, jn, yO, yl, yn ......... Bessel functions 

CTM3M): erf, eYfe rsssscsseereeeneeeee CTOr function and complementary error function 
exp(3M): exp, log, log10, pow, sqrt .... exponential, logarithm, power, square root functions 
floor(3M): floor, ceil, fmod, fabs .. . floor, ceiling, remainder, absolute value functions 


gamma(3M) . log gamma function 
hypot(3M) ... . Euclidean distance function 
matherr(3M) .. . error-handling function 


sinh(3M): sinh, cosh, tanh 
trig(3M): sin, cos, tan, asin, acos, 
atan, atan2 ...... 


. hyperbolic functions 


. trigonometric functions 


3N Networking Support Utilities 


t_accept(3N) 
t_alloc(3N) ... 
t_bind(3N) ... 


. accept a connect request 
. allocate a library structure 
. bind an address to a transport endpoint 


t_close(3N) ... . close a transport endpoint 

t_connect(3N) . establish a connection with another transport user 
t_error(3N) . produce error message 

t_free(3N) . free a library structure 

t_getinfo(3N) ... ww. get protocol-specific service information 
t_getstate(3N) .. get the current state 


. listen for a connect request 


t_listen(3N) ... 
t_look(3N) .... ... look at the current event on a transport endpoint 
t_open(3N) .. establish a transport endpoint 


t_optmgmt(3N) . manage options for a transport endpoint 

t_rev(3N) wes . receive data or expedited data sent over a connection 
t_revconnect(3N) . receive the confirmation from a connect request 
t_revdis(3N) . . retrieve information from disconnect 


t_revrel(3N) . . acknowledge receipt of an orderly release indication 
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.. Feceive a data unit 
receive a unit data error indication 


t_revudata(3N) ... 
t_revuderr(3N) 


t_snd(3N) .... .. send data or expedited data over a connection 
t_snddis(3N) .. send user-initiated disconnect request 
t_sndrel(3N) ... initiate an orderly release 

t_sndudata(3N) send a data unit 

t_sync(3N) .... .. synchronize transport library 


t_unbind(3N) ... .. disable a transport endpoint 


8PPS Sequent Parallel Programming Library 


intro(3PPS) 
brk(3PPS): brk, sbrk ... 
cpus_online(3PPS) 
m_fork(3PPS) ...... 
m_get_myid(3PPS) 
m_get_numprocsa(3PPS) 
m_kill_procs(3PPS) ...... kill child processes 
m_lock(3PPS): m_lock, m_unlock lock, unlock locks 
M_NEXE(BPPS) ..cresssscssssseeeesersresseserserecess increment global counter 
m_park_procs(3PPS): m. isi 

m_rele_procs 
m_set_procs(3PPS) 
m_single(3PPS): m_single, 


.. introduction to Parallel Programming Library 
.. change private data segment size 

.. returns the number of CPUs on-line 

execute a subprogram in parallel 

return process identification 

return number of child processes 


.. suspend and resume child process execution 
.. set number of child processes 


m_multi ... mark single-process code section 
m_sync(3PPS) . .. check in at barrier 
s_lock(3PPS): s_init_lock, s_lock, 

B_C]OCK, S_UDIOCK ssssessssssssssssssceerssneenesees initialize, lock, unlock locks 
s_wait_barrier(3PPS): s_init, barrier; 

S_WAIt_DAYTICY w.sssessecesssveeees .. initialize barrier, wait at barrier 


shbrk(3PPS): shbrk, shsbrk 
shmalloc(3PPS): shmalloc, 
Shrealloc, shfTCC ...ssssscsscecserssesessssseeessees shared memory allocator 


.. change shared data segment size 


3S Standard I/O Library Routines 


ctermid(3S) .. 
cuserid(3S) .... 


.. generate filename for terminal 
.. get character login name of the user 


fclose(3S): fclose, fAUSH .....ssssssesserssenes close or flush a stream 
ferror(3S): ferror, feof, clearerr, 

MLIGTIO: ssssesavsccessnars ucssanssscsvesescantsssesetsascassesc’ stream status inquiries 
fopen(3S): fopen, freopen, fdopen . open a stream 


fread(3S): fread, fwrite .......... 
fseek(3S): fseek, rewind, ftell 
getc(3S): getc, getchar, fgetc, getw 
gets(3S): gets, fgets .. get a string from a stream 
popen(3S): popen, pclose . initiate pipe to/from a process 
print{(3S): printf, fprintf, sprintf ...... . print formatted output 


binary input/output 
.. reposition a file pointer in a stream 
.. get character or word from a stream 
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putc(3S): putc, putchar, fputc, 
putw 
puts(3S): puts, fputs ... 

scanf(3S): scanf, fscanf, sscanf 
setbuf(3S): setbuf, setvbuf 
stdio(3S) ... 
system(3S) 


. put character or word on a stream 

. put a string on a stream 

. convert formatted input 

. assign buffering to a stream 

. standard buffered input/output package 
. issue a shell command 

tmpfile(3S) .. . create a temporary file 

tmpnam(3S): tmpnam, tempnam . create a name for a temporary file 
WNGSECSS)! ssccscssccsscssssasasiessssscexavansevetetnes push character back into input stream 
vprint{(3S): vprintf, vfprintf, 

NSPE sccscsssseqnessesusssaenseseasemmaneeeanrs print formatted output of a varargs argument list 


3SEQ Sequent I/O Library Routines 


dis386(83SEQ) 
getgeombyname(3SEQ) .. 
getmntent(3SEQ): addmntent, 
endmntent, getmntent, 
hasmntopt, setmntent . 
getpseudotty(3SEQ) . 
getscsiinfo(3SEQ): getscsiinfo, 


disassemble Series 386 instructions 
get disk geometry by name 


get file system descriptor file entry 
.. get pseudo terminals 


BetScSiMAtCh .......sesssceseeeseceseesscessoreseeseees get scsiinfo structure 

getusclk(3SEQ): getusclk, 

SCH ANIG cassesececcsccecesceseiesssnsssiescsssesscese get/init microsecond clock 

getzdinfo(3SEQ): getzdinfo, 

getzdinfobyname ... . get zdinfo structure 

initgroups(3SEQ) . initialize group access list 

nblocks(3SEQ) .... . calculate number of blocks and indirect blocks 


offline_all(3SEQ) 
read_constab(3SEQ) . 
valloc(8SEQ) 


. take all but one active processor off line 
. read constab entries into a structure 
. aligned memory allocator 


3X Special Routines 


assert(3X) . . verify program assertion 
crypt(3X) .. . password and file encryption functions 
curses(3X) . terminal] screen handling and optimization package 


directory(3X): opendir, readdir, 

telldir, seekdir, rewinddir, closedir .... directory operations 
getspent(3X): getspent, getspnam, 

setspent, endspent, fgetspent, 

Ickpwdf, ulckpwdf .. 
Idahread(3X) ....... 
Idclose(3X): Idclose, Idaclose 
ldfhread(3X) ... 
Idgetname(3X) . 


.. get shadow password file entry 

. read the archive header of a member of an archive file 
. close a common object file 

read the file header of a common object file 

.. Tetrieve symbol name for common object file symbol 
table entry 
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Idlread(3X): Idlread, Idlinit, Idlitem .. manipulate line number entries of a common object 
file function 

ldlseek(3X): ldlseek, ldnlseek............... seek to line number entries of a section of a common 
object file 

.. seek to the optional file header of a common object file 

. open a common object file for reading 

.. seek to relocation entries of a section of a common 
object file 

ldshread(3X): ldshread, ldnshread .... read an indexednamed section header of a common 
object file 

. seek to an indexednamed section of a common object file 

. compute the index of a symbol table entry of a 
common object file 


Idohseek(3X) 
ldopen(3X): Idopen, Idaopen 
Idrseek(3X): Idrseek, Idnrseek . 


Idsseek(3X): ldsseck, Idnsseek ... 
ldtbindex(3X) 


ldtbread(3X) . . read an indexed symbol table entry of a common object file 
ldtbseek(3X) . . seek to the symbol table of a common object file 
logname(3X) .... . return login name of user 

malloc(3X): malloc, free, realloc, 

calloc, mallopt, mallinfo .....ssecseeeseaee fast main memory allocator 


ndbm(3X): dbm_open, dbm_close, 
dbm_fetch, dbm_store, 
dbm_delete, dbm_firstkey, 
dbm_nextkey, dbm_error, 
dbm_clearerr, dmb_blkflush 
plot(3X) ........ 
putspent(3X) . 
regemp(3X): regemp, regex . 
sputl(3X): sputl, sget] 
utadduser({3X): ut_add_user, 

Ut_delete_user ...ssscssseeseesseen sss add/delete users in utmp file 


. database subroutines 

. graphics interface subroutines 
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. compile and execute regular expression 

. access long integer data in a machine-independent fashion 


4 File Formats 


INtTO(4) csesssoscrsrerssscecssssseeessncseeensenensarerees introduction to file formats 
a.out(4) .. . common assembler and link editor output 
acct(4) ..... . per-process accounting file format 


addusr_def{4) 
alias(4) .. 
ar(4) .... 
backup_codes(4) 
backup_codes1(4)' 
backup_dev(4) . 
backup_info(4) 
cftime(4) .... 
checklist(4) 
constab(4) .. 
core(4) .... 
cpio(4) . 


. add user defaults 

. alias file for FACE 

. see C and Language Tools Binder 
. backup cycle code definitions 

. backup subcode definitions 

. backup devices 

. backup set definitions 

. language specific strings 

. list of filesystems processed by fsck and ncheck 
. constructed devices table 

. format of core image file 

. format of cpio archive 


cronlog(4) .. . cron history file 
crontabs(4) . clock daemon file 
devtab(4) .... . Virtual device table 
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fs(4): fs, inode ... format of file system volume 
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group(4) .... group file 
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loginlog(4) log of failed login attempts 
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profile(4) ... setting up an environment at login time 
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reloc(4) .. relocation information for a common object file 
scesfile(4) format of SCCS file 
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shadow(4) . .. Testricted password file 

shells(4) .... shell table 
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syms(4) .. common object file symbol table format 
sys_config(4) format of a system configuration file 
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task(4) ... .. global security table 

term(4) .. .. format of compiled term file 

termcap(4) .. terminal capability data base 

PerminlO(Aa) .sercssecsiasssssersassesssesessescsssossssns terminal capability database 
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unistd(4) .... 
utmp(4): utmp, wtmp 
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5 Miscellaneous 


intro(5) ... .. introduction to miscellany 
ascli(5) .... map of ASCII character set 
environ(5) . .. user environment 

fentl(5) .... .. file control options 

math(5) math functions and constants 
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types(5) ... ... primitive system data types 
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7 Special Files 


intro(7) ... .. introduction to special files 

clone(7) open any minor device on a STREAMS driver 

empt(7) ... .. compatibility partitioning driver 

CNT). ssssovecsssessssececces essatongsitcun tna .. pseudoconsole driver 

consmem(7): consmem, 8m, 88 console memory drivers 

CONSOE(7)  sressseessseneenes coasseonisaats ... console interface 

kmmem(7): kMBmem, kMWmen ...... MULITBUS memory 

1d0(7) .. STREAMS tty line discipline 

log(7) ... .. interface to STREAMS error logging and event tracing 

1p{7) sve .. Systech parallel line printer interface 

Ipmod(7) .. parallel printer canonical processing module 

mbad(7) .. .. MULITBUS adapter 

mem(7): mem, kmem .. . core memory 

mtio(7) UNIX magnetic tape interface 

null(7) . the null file 

PMAP(T) resscescerseveee 7 .. nap physical addresses into processs virtual address 
space 

sa(7) .... .. devices administered by System Administration 


sced(7) SCSI/Ethernet/Diagnostics board 
sd(7) . SCSI disk controller 

sp{7) . STREAMS pipe device 

ssm(7) System Services Module 


Systech MTI-800/1600/1650 terminal multiplexor driver 
STREAMS ioctl commands 

STREAMS pseudo terminal driver 

Generic STREAMS tty driver interface 

general terminal interface 
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st(7) 
streamio(7) 
streampty(7) . 
streamtty(7) 
termio(7) 
tg(7) .... 
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timod(7) Transport Interface cooperating STREAMS module 
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x8(7) 08 .. Xylogics 781 terminal multiplexor driver 

xt(7) .. .. Xylogics 472 MULITBUS magnetic tape interface 
zd(7) .. .. dual-channel disk controller 


8 Stand-Alone Utilities 


intro(8) .. .. introduction to system standalone utilities 
ccsformat(8) .. standalone embedded SCSI disk formatter 
boot(8) .. run a standalone program or bring up the operating 


system 
.. perform a standalone data transfer 
.. standalone memory dump 
.. print the VTOC of a standalone disk device 
zdformat(8) . .. standalone disk formatter for dual-channel disk controller 
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st: Systech MTI-800/1600/ 

hpio: Hewlett-Packard 

of DASI 300 and 300s terminals 
handle special functions of DASI 
DASI 300 and 300sterminals 300, 
special functions of DASI 300 and 
usclk: 

dis386: disassemble Series 

DASI 450 terminal 

handle special functions of the DASI 
xt: Xylogics 

between long integer and base- 

xs: Xylogics 

integer and base-64 ASCII string 


abs: return integer 

fabs: floor, ceiling, remainder, 
t_accept: 

requests 

utime: set file 

touch: update 

file 

initgroups: initialize group 
setgroups: set group 
machine-independent/ _sputl, sgetl: 
ldfen: common object file 
endutent, utmpname, getutpid: 
access: determine 

acct: enable or disable process 
acctcon1, acctcon2: connect-time 
acctprel, acctpre2: process 
turnacct: shell procedures for 
runacct: run daily 

/accton, acctwtmp: overview of 

of accounting and miscellaneous 
diskusg: generate disk 

acct: per-process 

acctcom: search and print process 
acctmerg: merge or add total 
command summary from per-process 
fwtmp, wtmpfix: manipulate connect 
accounting 

format 

per-process accounting records 
accounting files 

accounting 
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1650 terminal multiplexor driver... 
2645A terminal tape file archiver 
300, 300s: handle special functions. 
300 and 300s terminals... 
300s: handle special functions of.. 
300s terminals........ccsccecseee 
32-bit microsecond counter. 
386 instructions 
450: handle special functions of the 
450 terminal ........sssssessssesseereesseeenees 
472 MULITBUS magnetic tape interface 
64 ASCII String......essscsscssessesseeseeseee 
781 terminal multiplexor driver.. 
a641, 164a: convert between long. 
abort: generate an IOT fault 
abs: return integer absolute value... 
absolute value .......scsesesnes 
absolute value functions.. 
accept a connect request.. 
accept, reject: allow or prevent LP. 
access and modification times...... 
access and modification times of a file 
access; determine accessibility of a... 
access list... 
access list... 
access long integer data in a.. 
ACCESS TOULINES........0+4 
access utmp file entry. 
accessibility of a file.. 
accounting... 


-usclk(7) 


accept 1M) 


accounting acctcon( 1M) 
accounting. me 1M) 
accounting 

accounting. 

accounting and miscellaneous/. 


accounting commands.. 
accounting data by user ID... 
accounting file format.. 
accounting files. 
accounting files 
accounting records.. 
accounting records... 
acct: enable or disable process.. 
acct: per-process accounting file 
acctems: command summary from... 


aesvad acct(4) 
acctcom(1) 
.acctmerg(1M) 

acctcms(1M) 


acctcom: search and print process... acctcom(1) 
acctcon], acctcon2: connect-time .......cscssesrseereee acctcon(1M) 
1 
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acctconl, 

acctwtmp: overview of accounting/ 
of accounting and/ acctdisk, 
accounting files 

acctdisk, acctdusg, 


accounting 

acctprel, 

acctdisk, acctdusg, accton, 

release indication t_revrel: 


trig: sin, cos, tan, asin, 

helplog: monitor help 

sigaction: examine and change signal 
killall: kill all 

offline_all: take all but one 
mbad: MULITBUS 

addcmdopt: 

addformopt: 

addmenuopt: 

acctmerg: merge or 
addusr.def: 

putenv: change or 

menu 

ut_add_user, ut_delete_user: 
option to a menu 

menu 

hasmntopt, setmntent: get file/ 
map an open file into the processs 
munmap: unmap part of the processs 
addresses into processs virtual 
t_bind: bind an 

pmap: map physical 


menu 


files 

print service Ipfilter: 
print service lpforms: 
admin: create and 

SA: devices 


SA: devices administered by System 
sysadm: menu interface to do system 
uadmin: 

uadmin: 

swap: swap 

/usr/ 

/onproc: run a command with priority 
alarm: set a process 


/display application specific 
pathalias: 

valloc: 

t_alloc: 

brk, sbrk: change data segment space 
free, realloc, calloc: main memory 


acctcon2: connect-time accounting 


acctprel, acclipedd process... 
acctpre2: process accounting. 
acctwtmp: overview of accounting and/ 
acknowledge receipt of an orderly.. 
acos, atan, atan2: trigonometric’ 
actions... 
actions.. 
active processes. 
active processor off line.. 


__revrel(3N) 
..trig(3M) 
helplog(4) 
sigaction(2) 
-killall(1M) 
.offline. mae ae 


add a command option to a men’ 
add a form/SELECT window option to a 
add a menu option to a menu... 
add total accounting files 
add user defaults........05. 


add value to environment. ....putenv(3C) 
addcmdopt: add a command option to a.....addemdopt(1M) 
add/delete users in utmp file ..utadduser(3X) 


addformopt: add a form/SELECT window...addformopt(1M) 
addmenuopt: add a menu option to a....... addmenuopt(1M) 
addmntent, endmntent, getmntent,.. getmntent(3SEQ) 
address space..... ...mmap(2SEQ) 
address space. 
address space.... 
address to a transport endpoint.. 
addresses into processs virtual address space 
addusr.def: add user defaults addusr_def(4) 
admin: create and administer SCCS.. -admin(1) 
administer filters used with the LP Ipfilter(1M) 
administer forms used with the LP ..|pforms(1M) 
administer SCCS files. .admin(1) 
administered by System 
Administration... 
administration.. 
administrative control. 
administrative control 
administrative interface 
adm/loginlog: log of failed login attempts 
aging, PFF, swapping, or processor/. 
Alarm CLOCK ......ssscssseescecesseeseeseesees 
alarm: set a process alarm clock 
alarms and/or the working indicator. 


“indicator(1F) 


lias HlEHOF EACH wisisssesciscessnisecssssssccinssanccusvcavssessauseesse alias(4) 
aligned memory allocator. -valloc(83SEQ) 
allocate a library structure... «.t_alloc(3N) 
allocation. wae bTK(2) 
allocator.... -malloc(3C) 


DYNIX/ptx Reference Manual 


Permuted Index 


mallopt, mallinfo: fast main memory 
shrealloc, shfree: shared memory 
valloc: aligned memory 

editor output 

to maintenance commands and 

the working/ indicator: display 
lookup 


and libraries 

be: 

ott: files that hold object 

cpio: format of cpio 

the archive header of a member of an 
ar: common 

Idahread: read the 
2645A terminal tape file 
tar: tape file 

cpio: copy file 

varargs: handle variable 
print formatted output of a varargs 
xargs: construct 

getopt: get option letter from 

echo: echo 

expr: evaluate 

message: puts its 

be: arbitrary-precision 

asa: interpret 

characters 

Aocaltime, gmtime, asctime, cftime, 
ascii: map of 


archive file 


between long integer and base-64 
ctime, localtime, gmtime, 

trig: sin, cos, tan, 

as: common 

a.out: common 


assert: verify program 

system commands 

/program for generating/modifying 
assist: 

generating/modifying ASSIST menus/ 
later time 

trig: sin, cos, tan, asin, acos, 

/sin, cos, tan, asin, acos, atan, 
double-precision number strtod, 
strtol, atol, 

strtol, 

change login password and password 
contro] over various process 

res: change RCS file 

dumpconf: dump kernel 
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malloc(3X) 
.shmalloc(3PPS) 


allocator... 


a.out: common assembler an: 
application program.......sss 
application specific alarms and/or.. 
apropos: locate commands a keywor 
ar: archive file format. 


ar: maintain archives. ..see C and Lang Tools Binder 
arbitrary-precision ari etic language ..-be(1) 
architecture information... .0tt(4) 
ATCHIVGE sssicessessassevs cpio(4) 
archive file... ..ldahread(3X) 
archive file format ..see C and Lang Tools Binder 
archive header of a member of an.. ..ldahread(3X) 


archiver. 
archiver 
archives in and out... 
argument list. 
argument list... 
argument list(s) and execute command.. 
argument vector 
AFZUMENES......000 
arguments as an expression 
arguments on message line.. 
arithmetic language.......... 
ASA carriage control characters. 
asa: interpret ASA carriage contro 
ascftime, mktime, tzset: convert/. 
ASCII character set... 
ascii: map of ASCII chara 
ASCIL Str cicssssssicscssesereseseseserns 

asctime, cftime, ascftime, mktime, tzset/... 
asin, acos, atan, atan2: trigonometric’... 
F-X-1:15 30) ) () oe see Cand Lang Tools Binder 
assembler and link editor output... -a,out(4) 
assert: verify program assertion. 
AOSOTCION viscicccaassecccsasessgssesusescaass 
assist: assistance using operating.. 
ASSIST menus or command forms... 
assistance using operating system commands. 
astgen: program for.. 
at, batch: execute commands at a.. 
atan, atan2: trigonometric functions.. 
atan2: trigonometric functions.. 
atof: convert string to............ 
atoi: convert string to integer. 
atol, atoi: convert string to integer.. 
attributes... 
attributes... 
attributes... 
auto-configuration device table 


.ctime(3C) 
.-ascii(5) 
.ascii(5) 


.astgen(1) 
assist(1) 
he 


strtol(3C) 
strtol(3C) 
passwd(1) 
-proc_ctl(2SEQ) 
res(1) 
..dumpconf( 1M) 
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language 

backup.codes: 

backup.dev: 

ckbupscd: check filesystem 
backup.info: 
backup.codes1: 

definitions 

definitions 


m_syne: check in at 
initialize barrier, wait at 
/g_wait_barrier: initialize 
of pathnames 

at, 

language 

procedures 


bessel: jO, jl, jn, yO, y1, yn: 
Bessel functions 


fread, fwrite: 

bp: 

bsearch: 

tfind, tdelete, twalk: manage 
tmp_affinity: 

t_bind: 

sum: print checksum and 

prtvtoc: print the VTOC ofa 
sigprocmask: examine and change 
number of blocks and indirect 
nblocks: calculate number of 

df: report number of free disk 
consistency check based on the 
consistency check based on the BOM 
bootflags: display/change system 
installboot: installs a 

bring up the operating system 
boot flags 


allocation 

segment size 

table 

stdio: standard 
setbuf, setvbuf: assign 
mailbug: submit a 
devbuild, devdestroy: 
sccstorcs: 

mknod: 


awk: pattern scanning and processing 
backup cycle code definitions.. 
backup devices... 
backup schedule 
backup set definitions.......... 
backup subcode definitions. 
backup.codes: backup cycle code 
backup.codes1: backup subcode. 
backup.dev: backup devices... 
backup.info: backup set definitions.. 
banner: make posters. 
barrier... 
barrier... 
barrier, wait at barrier 
basename, dirname: deliver portions. 
batch: execute commands at a later tim 
be: arbitrary-precision arithmetic... 
bcheckre: system initialization.. 
bdflush: update daemon.. 
bdflush: update daemon... 


«-backup_info(4) 
-backup_codes1(4) 
...backup_codes(4) 
.backup_codes1(4) 
backup_dev(4) 
.-backup_info(4) 
Sdveees banner(1) 
m_sync(3PPS) 
.8_wait_barrier(3PPS) 
.8_wait_barrier(3PPS) 
..basename(1) 


Diff: Dig GifM.......sssssssssesssssssssssssssecsssessecsscenssensecesscennsese bdiff{1) 
Bessel functions... ..bessel(3M) 
bessel: j0, jl, jn, yO, yl, y ..bessel(3M) 


wb fs(1) 
.fread(3S) 


bfs: big file scanner... 
binary input/output. 
binary patcher... 
binary search a 80) 


binary search treesa..ssecsessssssessenssssensssoeensaneesreer tsearch(3C) 
bind a process to a processor. ..tmp_affinity(2SEQ) 
bind an address to a transport endpoint _bind(3N) 


block count of a file. 


block device....... 

blocked signals.. 

DIOCKS ....seseeeeeee 

blocks and indirect blocks... 

blocks and inodes.......ssssssocsssssrssossersesseneanenseesseneeeeneeneen df(1M) 
BOM sasiesmiasssomese bomverify(1M) 
bomverify: perform an installation.. bomverify(1M) 
DOOt MAgGs......sssssessssessssssssseccessessseesssnsonsneseoeseatens bootflags(1M) 
boot program on a dis! installboot(1M) 
boot: run a standalone program OF s.ssssssesesesssseeseeronee boot(8) 
bootflags: display/change system. -bootflags(1M) 
bp: binary patcher..... «-bp(1M) 
brk, sbrk: change data segment space -brk(2) 
brk, sbrk: change private data... rk(3PPS) 


bsearch: binary search a sorted 
buffered input/output package . 
buffering to a stream... 
bug report or enhancement request 
build and destroy virtual devices 
build RCS file from SCCS file.. 
build special file... 


devbuild( 1M) 
..scestores(1) 
-mknod(1M) 
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swab: swap b; 


cc: 
cflow: generate 


exref: generate a 
ctrace: 
list: produce 


nblocks: 
de: desk 
cal: print 


indirect blocks 


stat: data returned by stat system 
syscall: indirect system 

cu: 

malloc, free, realloc, 

malloc, free, realloc, 

introduction to Sequent system 
intro: introduction to system 

Ip, cancel: send/ 

LP print service Ip, 
Ipmod: parallel printer 
description into a terminfo/ 

asa: interpret ASA 


gence: create a front-end to the 
disk formatter 


an SCCS delta 
remainder, absolute value/ floor, 
floor, ceil, fmod, fabs: floor, 


ctime, localtime, gmtime, asctime, 


sigprocmask: examine and 
brk, sbrk: 
passwd: 
chmod: 
chmod: 
putenv: 
chown: 
chown, chgrp: 
nice: 

brk, sbrk: 
res: 

chroot: 
chroot: 


attributes 
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build system configuration files ...config( 1M) 


swab(3C) 


C compiler. see C and Lang Tools Binder 
C flowgraph . see C and Lang Tools Binder 
C language preprocessor........see C and Lang Tools Binder 
C program beautifier. see C and Lang Tools Binder 
C program checker... ..see C and Lang Tools Binder 
C program cross-reference.....see C and Lang Tools Binder 
C program debugger. see C and Lang Tools Binder 
C source listing... see C and Lang Tools Binder 


cal; print calendar.... 
calculate number of blocks and. 
calculator.. 
calendar.... 
calendar: reminder service. 
call... 
call.. 
call another UNIX system. 
calloc: main memory allocator.. 


Jealendart 1) 
.-8tat(5) 
ie 


cancel requests to the LP print service 
cance]; send/cancel requests to the.. 
canonical processing module.... 
captoinfo: convert a termcap.. 
carriage control characters... +» 89a(1) 
cat: concatenate and print files. .cat(1) 
cb: C program beautifier........see C and Lang Tools Binder 
cc command..... 
ce: C compiler... 
CCSformat: standalone embedded SCSI... 


... cesformat(8) 


cd: change working directory........s0« .cd(1) 
cde: change the delta commentary of.. .cde(1) 
ceil, fmod, fabs: floor, ceiling,........ ..floor(3M) 
ceiling, remainder, absolute value/..... .-floor(3M) 


eflow: generate C flowgraph...see C and Lang Tools Binder 
cftime, ascftime, mktime, tzsetv... .ctime(3C) 


cftime: language specific strings .cftime(4) 
change blocked signals...........0 ..8igprocmask(2) 
change data segment space allocation.........c.sssssssseeseee brk(2) 


change login password and password 
change mode... 
change mode of file.. 
change or add value to environment. 
change owner and group of a file. 
change owner or group........ 
change priority of a process 
change private data segment size 
change RCS file attributes. 
change root directory........ 
change root directory for a command.. 


«passwd(1) 
..chmod(1) 
..chmod(2) 
..putenv(3C) 
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shbrk, shsbrk: 

sigaction: examine and 
bootflags: display/ 

shutdown: shut down system, 
ede: 

newform: 

helpadm: 

rename: 

delta: make a delta ( 


parameters vm_ctl: examine and 
ced: 

chdir: 

pipe: create an interprocess 


zd: dual- 

standalone disk formatter for dual- 
strstr: find first occurrence of 
ungetc: push 

conversion tables _chrtbl: generate 
_tolower, _toupper, setchrclass: 
cuserid: get 

gete, getchar, fgetc, getw: get 

pute, putchar, fputc, putw: put 
ascii: map of ASCII 

fgrep: search a file fora 

diskinfo: disk device 

asa: interpret ASA carriage control 
_tolower, toascii: translate 

tr: translate 

lastlogin, monacct, nulladm/ 


filesystem directory consistency 
filesystem storage consistency 
checkfsys: 

fsck: filesystem consistency 
perform an installation consistency 
checkeq: 
ckbupscd: 
m_sync: 

ci: 

co: 
uucheck: 
eqn syntax. 


permissions file 


processed by fsck and ncheck 

sum: print 

chown, 

/m_rele_procs: suspend and resume 
times: get process and 

wait, waitpid: wait for a 
m_get_numprocs: return number of 
m_kill_procs: kill 

m_set_procs: set number of 


change shared data segment size 
change signal actions...... 


.shbrk(3PPS) 
...Sigaction(2) 


change system boot flags bootflags(1M) 
change system state .-Shutdown(1M) 
change the delta commentary of an SCCS delta.......... ede(1) 


change the format of a text file 
change the Help Facility database. 
change the name of a file... 
change) to an SCCS file... 
change virtual memory tuning 
change working directory... 
change working directory... 
Channel sscccicsessecsssccsesseze 


..newform(1) 
helpadm(1M) 
-rename(2) 
sicaaee delta(1) 


channel] disk controller 
CHATACtEL vs ssececcesseneavene ..Strstr(3C) 
character back into input stream. -ungete(3S) 
character classification and.. .chrtbl(1M) 
character handling... ..ctype(3C) 
character login name of the user. cuserid(3S) 
character or word from a stream. getc(3S) 
character or word on a stream.. -pute(3S) 
character set...... ascii(5) 
character string igrep(1) 
characteristic databasc.. -diskinfo(4) 
CHAT ACHCYDS scsssisia tcscsvscsssatvesseadsacevesvitisnnddestseasaissncaiccsoscend asa(1) 
characters 


SHRP ACE OTD scecasicsssicasussstsvicnsninnitarivieaiensovesmneamiseansciesaneveal tr(1) 
chargefee, ckpacct, dodisk,.... acctsh(1M) 
chdir: change working directory ....e.ssesssessseessoesoronnees chdir(2) 
check.. dcheck(1M) 
check.. icheck(1M) 
check a filesystem. ..checkfsys(1M) 
check and interactive repair .....sesssessssssesessseseesseeses fsck(1M) 
check based on the BOM......... -bomverify(1M) 
check documents for correct eqn syntax -checkeq(1) 
check filesystem backup schedule... ‘kbupsed(1M) 
check in at barrier....... -m_syne(3PPS) 


check in RCS revisions.. seeeCi(1) 
check out RCS revisions.. 
check the uucp directories and. 
checkeq: check documents for correct. 
checkfsys: check a filesystem 
checklist; list of filesystems... 
checksum and block count of a file .. 
chgrp: change owner or group 
child process execution 
child process times .times(2) 
child process to stop or terminate - Wait(2) 
child processes ..m_get_numprocs(3PPS) 
..m_kill_procs(3PPS) 
...m_set_procs(3PPS) 


»..checkeq(1) 
..check fsys(1M) 
checklist(4) 


m_park_procs(3PPS) 
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file 


command 
classification and conversion/ 


schedule 

nulladm, pretmp,/ chargefee, 
chrtbl: generate character 

clri: 

ferror, feof, 


a shell (command interpreter) with 
alarm: set a process alarm 
usclk_init: get/init microsecond 
cron: 

crontabs: 


STREAMS driver 
ldclose, Idaclose: 
close: 

t_close: 


felose, fflush: 
/telldir, seekdir, rewinddir, 


driver 


communicate to a/ cocreate, cosend, 
coreceive, codestroy: communicate/ 
backup.codes: backup cycle 

m_multi: mark single-process 
/cosend, cocheck, coreceive, 


to form error log dmesg: 
setcolor: redefine or create a 


comb: 

to two sorted files 

mcs: manipulate the object file 
cde: change the delta 

aout: 

ldclose, ldaclose: close a 

Idfhread: read the file header of a 
number entries of a section of a 
to the optional file header of a 
relocation entries of a section of a 
indexednamed section header of a 
to an indexednamed section of a 
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chmod: change mode..... 
chmod: change mode of file.. 
chown: change owner and group of a 
chown, chgrp: change owner or group. 
chroot: change root directory 
chroot: change root directory for a. 
chrtbl: generate character.. 
ci: check in RCS revisions.... 
ckbupscd: check filesystem backu 
ckpacct, dodisk, lastlogin, monacct, . 
classification and conversion tables...... 
Clear 1NOdC.....ssesscesesoeeeeesseenseessscareneaceeeees 
clearerr, fileno: stream status inquiries. 


clock 
clock .getusclk(3SEQ) 
Clock daeMon...........scscscscsesserersacorsessconsseacareseuenararecsens cron(1M) 


clock daemon file.. .crontabs(4) 


clock: report CPU time used... .clock(3C) 
clone: open any minor device on a .».-Clone(7) 
close a common object file. .dclose(3X) 
close a file descriptor........- ..close(2) 
close a transport endpoint... t_close(3N) 
close: close a file descriptor. +». Close(2) 
close or flush a stream...... .fclose(3S) 
closedir: directory operations. 


.directory(3X) 
clri: clear inode... .clri(1M) 
cmp: compare two files.. 
cmpt: compatibility partitioning 
cen: pseudoconsole driver...... 
co: check out RCS revisions. 
cocheck, coreceive, codestro 
cocreate, cosend, cocheck,. 
code definitions. 


col: filter reverse line-feeds.. 
collect system diagnostic messages... 


comb: combine SCCS deltas... 
combine SCCS deltas. 
comm: select or reject lines common 
COMMENL SCCLION......cesesecseeeeeeee 
commentary of an SCCS delta. 
common assembler and link editor output. 
common object file... 
common object file.. 
common object file... 
common object file. 
common object file 
common object file. 
common object file... 


.-ldclose(3X) 
..ldfhread(3X) 
cts Idlseek(3X) 
..ldohseek(3X) 
-ldrseek(3X) 
..ldshread(3X) 
....ldsseek(3X) 
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index of a symbol table entry of a 

an indexed symbol table entry of a 
seek to the symbol table of a 
linenum: line number entries in a 
reloc: relocation information for a 
senhdr: section header for a 

ldfen: 

" ]dopen, Idaopen: open a 
/manipulate line number entries of a 
ldgetname: retrieve symbol name for 
syms: 
filehdr: file header for 
glossary: definitions of 
comm: select or reject lines 
cocheck, coreceive, codestroy: 
ipes: report inter-process 

stdipe: ftok: standard interprocess 
tfipe: interprocess 
infocmp: 

resdiff: 

emp: 

secsdiff: 

diff: differential file 
diff3: 3-way differential file 

diremp: directory 

cmpt: 

regemp: regular expression 

regcmp, regex: 

regexp: regular expression 
term: format of 

ce: C 

ec: forms 

tic: terminfo 

yace; yet another compiler- 

yacc: yet another 

erf, erfc: error function and 

cprs: 

compress, uncompress, zcat: 

pack, peat, unpack: 

and expand data 

entry of a common object/ Idtbindex: 
cat: 

test: 

files 

pathconf, fpathconf: get 

sysconf: get 

dumpconf: dump kernel auto- 
mod_config: format of a module 
sys_config: format of a system 
config: build system 

showcfg: show the 

lpadmin: 


symbols 


descriptions 


...ldtbindex(3X) 
.Idtbread(3X) 
.Idtbseek(3X) 
-linenum(4) 
.-Teloc(4) 


common object file... 
common object file 


common object file 
common object file.... 
common object file access routines. 
common object file for reading 
common object file function..... 
common object file symbol table/ 
common object file symbol table forma 
Common Object files... seecccsssceseteevseeeees: 
common operating system terms and 
common to two sorted files 
communicate to a process. 
communication facilities status. 
communication package... 
communication reporter ... 
compare or print out terminfo. 
compare RCS revisions 
compare two files......... 
compare two versions of an SCCS file 
comparison . 
comparison . 
comparison. 
compatibility partitioning driver 
COMPIIC......sssesesssecsesssecerersnenrrseeeeees 
compile and execute regular expression.. 
compile and match routines. 
compiled term file. 
compiler.. 
compiler 
compiler 
compiler... 
compiler-compiler 
complementary error function 
compress an object file. 
compress and expand data. 


= "Tdopen(3X) 
Idlread(3X) 
-ldgetname(3X) 


.glossary(1) 
comm(1) 


tdipe(3C) 
-tfipe(1M) 
.-infoemp(1M) 
-resdiff(1) 


«yacc(1) 
erf(3M) 
ng Tools Binder 
compress(1) 


compress and expand fileS.......ssscssseessenrsseceneereneeress pack(1) 
compress, uncompress, zcat: compress. ..compress(1) 
compute the index of a symbol table ldtbindex(3X) 
concatenate and print files...... .cat(1) 


..test(1) 
..config( 1M) 
pathcon{(2) 
.-syscon{{(2) 
..dumpconf(1M) 
mod_config(4) 
.-sys_config(4) 


condition evaluation command... 
config: build system configuration.. 
configurable pathname variables... 
configurable system variables 
configuration device table 
configuration file... 
configuration fil 


configuration fileS..........cscesserssseensrsscesassesseeeeesuenes config(1M) 
configuration of the machine ..showefg( 1M) 
configure the LP print service... -lpadmin(1M) 
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t_reveonnect: receive the 

fwtmp, wtmpfix: manipulate 
t_accept: accept a 

t_listen: listen for a 

receive the confirmation from a 
establish an out-going terminal line 
data or expedited data sent over a 
send data or expedited data over a 
t_connect: establish a 

acctconl, acctcon2: 

dcheck: filesystem directory 
icheck: filesystem storage 

fsck: filesystem 

bomverify: perform an installation 
quotacheck: filesystem quota 
drivers 


console: 
consmem, sm, ss: 


read_constab: read 

header for implementation-specific 
math: math functions and 
unistd: file header for symbolic 
constab: 

deroff: remove nroff, tbl, and eqn 
Uutry: try to 

Is: list 

sigcontext: get signal 

set anW/or get signal stack 

esplit: 

sd: SCSI disk 

tm: SCSI tape 

ts: SCSI tape 

wd: SSM SCSI disk 

zd; dual-channel disk 

disk formatter for dual-channel disk 
synchronize a co-process with the 
virtually hangup the specified 
tty: 

_tolower, toascii: translate/ 
units: 

character classification and 


terminfo description captoinfo: 

dd: 
long integers 13tol, ltol3: 
base-64 ASCII string a64l, 164a: 


dev_to_ttyname, ttyname_to_dev: 
/cftime, ascftime, mktime, tzset: 
ecvt, fevt, gevt: 

scanf, fscanf, sscanf: 

strtod, atof: 
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confirmation from a connect request........ t_revconnect(3N) 
connect accounting records.. 
connect request... 
connect request. 
connect request . 


.t_listen(3N) 
..t_revconnect(3N) 


connection... .-.dial(3C) 
connection... ..t_rev(3N) 
connection ...t_snd(3N) 


“t_connect(3N) 
...acctcon( 1M) 


connection with another transport user. 
connect-time accounting 
consistency check... 
consistency check . 
consistency check and interactive repair. 
consistency check based on the BOM 
consistency checker 
consmem, sm, ss: console memory 
console: console interface... 
console interface 
console memory drivers. 
constab: constructed devices table. 
constab entries into a structure. 


‘quotacheck( 1M) 

...consmem(7) 
.console(7) 
-console(7) 
.consmem(7) 
constab(4) 
read_constab(3SEQ) 


constants.. limits(4) 
constants... »..math(5) 
constants... unistd(4) 


constructed devices table. constab(4) 
constructs 
contact remote system with debugging on. 
contents of directory....... sd avnasisavengnananeenenses 
context... .sigcontext(2SEQ) 
context... -sigstack(2SEQ) 
context split 
controller. 
controller. 
controller... 
controller.. 
controller... 
controller... 
controlling FMLI object 
controlling terminal... 
controlling terminal (gentty) interface. 
conv: toupper, tolower, _toupper, 
conversion program. 
conversion tables..... 
convert a termcap description into a. 
convert and copy a file 
convert between 3-byte integers and 
convert between long integer and... 
convert major/minor numbers 
convert date and time to string. 
convert floating-point number to string. 
convert formatted input.......ssceseenseees 
convert string to double-precision number... 


dev_to_ttyname(3C) 
....ctime(3C) 

...ecvt(3C) 
scan{(3S) 
strtod(3C) 
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strtol, atol, atoi: 
password file scheme pwunconv: 
vsig: synchronize a 
UNIX-to-UNIX system 
system file 

dd: convert and 
cpset: 

cpio: 

cp, In, mv: 

volcopy: make literal 
transfer 

savecore: save a 


core: format of 

mem, kmem: 

and unset environment variables in 
cocreate, cosend, cocheck, 

checkeq;: check documents for 
trigonometric functions trig: sin, 
codestroy: communicate to/ cocreate, 
sinh, 

we: word 

sum: print checksum and block 
m_next: increment global 

usclk: 32-bit microsecond 


cpio: format of 


and group IDs 

clock: report 

cpus_online: returns the number of 
CPUs on-line 


an existing one 
setcolor: redefine or 
gence: 

tmpnam, tempnam: 
creat: 

fork: 

ctags: 

tmpfile: 

pipe: 

admin: 

tasktbl: 

setsid: 

pathconv: search Interpreter 


cronlog: 
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strtol(3C) 
-pwunconv(1M) 


convert string to integer 
converts from a two to a one.. 
co-process with the controlling FMLI object. 


copy ... 
copy... 
copy a file 
copy file and set mode, user, and group IDs. 
copy file archives in and out 
copy, link or move files.. 
copy of filesystem 
copy: perform a standalone data... 
core dump of the operating system.. 
core: format of core image file 
core image file 
core memory... 


core or in files ww 8et(1F) 
coreceive, codestroy: communicate to a/ .coproc( 1F) 
correct eqn syntax. .checkeq(1) 
cos, tan, asin, acos, atan, atan2: .trig(3M) 
cosend, cocheck, coreceive, -coproc(1F) 


cosh, tanh: hyperbolic functions 


count of a file. 
counter. 
counter.. 
cp, In, mv: copy, link or move files 
cpio archive ........04 7” 
cpio: copy file archives in and out. 
cpio: format of cpio archive 
cpp: C preprocessor.. see C and Lang Tools Binder 
cprs: compress object file see C and Lang Tools Binder 
cepset: copy file and set mode, USCY, ....sssesseseeeeeererees epset(1) 
CPU time used. «clock(3C) 
CPUs on-line... cpus_online(3PPS) 
cpus_online: returns the number of.......cpus_online(3PPS) 
crash: examine system images... .crash(1M) 
creat: create a new file or rewrite. .creat(2) 
CEALC & COLOL...cosssesessserseseeeeneerens .setcolor(1F) 
create a front-end to the cc command. .gence(1M) 
create a name for a temporary file .. 
create a new file or rewrite an existing one.. 
create a new process.... 
create a tags file....... 
create a temporary file.. 
create an interprocess channel.. 
create and administer SCCS files.. 
create security table in shared memory. 
create session and set process group ID.. 
criteria for filename 
cron: clock daemon.. 
cron history file... 
cronlog: cron history file 


.tasktbl(1M) 
setsid(2) 
»pathconv(1F) 
...cron(1M) 
.cronlog(4) 
.cronlog(4) 


DYNIX/ptx Reference Manual 


crontab: user 


exref: generate C program 
pg: file perusal filter for 


functions 
hashing encryption 
with C-like syntax 


terminal 
ceftime, ascftime, mktime, tzset/ 


scr_dump: format of 
optimization package 

the user 

line of a file 

cut: 

cross-reference 
backup.codes: backup 
bdflush: update 

bdflush: update 

cron: clock 

strerr: STREAMS error logger 
crontabs: clock 
pwdhd: 
runacct: run 
300s: handle special functions of 
450: handle special functions of the 
zcat: compress and expand 

prof: display profile 

time a command; report process 
termcap: terminal capability 
diskusg: generate disk accounting 
t_revuderr: receive a unit 

sputl, sgetl: access long integer 
plock: lock process, text, or 

t_snd: send 

t_rev: receive 

t_snd: send data or expedited 
stat: 

brk, sbrk: change private 

shbrk, shsbrk: change shared 
brk, sbrk: change 

t_rev: receive data or expedited 
copy: perform a standalone 

types: primitive system 
t_revudata: receive a 
t_sndudata: send a 


creation 


DYNIX/ pix Reference Manual 


Permuted Index 


crontab file 
crontab: user crontab file.. 
crontabs: clock daemon file.. 
cross-reference 


.crontabs(4) 


see C and Lang Tools Binder 


crypt: encode/decode... 
crypt: password and file encryption .. 
crypt, setkey, encrypt: generate..... 
csh: a shell (command interpreter)... 
csplit: context split .....sssesssesseeseeen 


<rypu(s0) 


ct: spawn getty to a remote terminal. ct(1C) 
ctags: create a tags file............ ctags(1) 
ctermid: generate filename for ctermid(3S) 
ctime, localtime, gmtime, asctime, ...ctime(3C) 
cetrace: C prog debugger.......... see C and Lang Tools Binder 
cu: call another UNIX system... 

curses screen image file......... 


curses: terminal screen handling and.. 
cuserid: get character login name of.. 
cut: cut out selected fields of each..... -cut(1) 
cut out selected fields of each line of a file.. we Cut(1) 
cxref: generate C program.....see C and Lang Tools Binder 
cycle code definitions. 
daemon... 
daemon... 
daemon... 
daemon... 
daemon file 
daemon to oversee password database. 
daily Accounting ....ccccseeseesere 
DASI 300 and 300s terminals... 
DASI 450 termina 
data.. 
data.. 
data and system activity. 
data base 
data by user I 

data error indication. 
data in a machine-independent/ 
data in memory. 
data or expedite: 
data or expedited data sent over a connection .. 
data over a connection. 
data returned by stat system call. 
data segment size.... 
data segment size.... 
data segment space allocation 
data sent over a connection. 
data transfer... 
data types 
data unit. 
data unit. 


“cuserid(3S) 


.crontabs(4) 
.«pwdhd(1M) 


-sputl(3X) 
plock(2) 
__snd(3N) 


at, “pevudata(3N) 
t_sndudata(3N) 
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diskinfo: disk device characteristic 
helpadm: change the Help Facility 
terminfo: terminal capability 

a terminal or query terminfo 
pwdhd: daemon to oversee password 
mkpwdbm: make a 

join: relational 

dbm_clearerr, dmb_blkflush: 
makewhatis: generate man page 
date: print and set the 

ascftime, mktime, tzset: convert 


/dbm_nextkey, dbm_error, 
dbm_delete/ dbm_open, 
dbm_close, dbm_fetch, dbm_store, 
/dbm_firstkey, dbm_nextkey, 
dbm_firstkey,/dbm_open, dbm_close, 
/dbm_fetch, dbm_store, dbm_delete, 
dbm_store, dbm_delete, dbm_firstkey, 
dbm_store, dbm_delete,/ 

dbm_open, dbm_close, dbm_fetch, 
pdbx, 


enable/disable patrol seeks on 
consistency check 


ctrace: C program 

pdbx, dbx: parallel 

try to contact remote system with 
crypt: encode/ 

timezone: set 

reset the current form field to its 
addusr.def: add user 

format disks or perform other 
gtty: set and get terminal state ( 
ut_add_user, ut_delete_user: add/ 
the delta commentary of an SCCS 
delta: make a 

ede: change the 

rmdel: remove a 

SCCS file 

comb: combine SCCS 

constructs 

whatis: 

close: close a file 

dup: duplicate an open file 

dup2: duplicate an open file 
setmntent: get file system 
getdtablemax: get maximum in-use 
getdtablesize: get 

setdtablesize: set 

de: 
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database.... 


database... 
database creation .......ccscee 
database for fast password lookup 
database operator... 
database subroutines. 
databases.. 


....pwdhd(1M) 
~mk pwdbm(1M) 


date and time to string. 
date: print and set the date. 
dbm_clearerr, dmb_blk flush: database, 
dbm_close, dbm_fetch, dbm_store, 
dbm_delete, dbm_firstkey,/. 
dbm_error, dbm_clearerr/.. 
dbm_fetch, dbm_store, dbm_delete,. 
dbm_firstkey, dbm_nextkey/. 
dbm_nextkey, dbm_error/..... 
dbm_open, dbm_close, dbm_fetch, ... 

dbm_store, dbm_delete, dbm_firstkey,/ 


dbx: parallel debugger............ see C and Lang Tools Binder 
de: desk calculator .. woe de(1) 
DCC disks........0 «sweepon(1M) 
dcheck: filesystem directory dcheck(1M) 
dd: convert and Copy & fil@.......sccssssssseecsaseserseneeneecesses dd(1M) 
debugger see C and Lang Tools Binder 
debugger... see C and Lang Tools Binder 
debugging on ..uutry(1M) 
decode.......... ..crypt(1) 
default system time zone timezone(4) 
Aefault values.........ceccccssscsssssssesesesenenssransnrsencasssseces reset(1F) 
defaults... addusr_def(4) 
defect management functions format(1M) 
eFUNCt) .escessssssseeroesosecsssersessncarsnseserssesseescanenssersseesseseecenee stty(2) 
delete users in utmp fil 

ON bas csesscesccassasescesescansaanesesoscesesvasvasacnsseeaiedssseieesassenonsososes ede(1) 
delta (change) to an SCCS file.. delta(1) 


delta commentary of an SCCS delta. 
delta from an SCCS file.. 
delta: make a delta (change. 


deroff: remove nroff, tbl, and eqn.. 
describe what a command i: 


descriptor close(2) 
descriptor.. dup(2) 
descriptor ..dup2(2) 


“getmntent(3SEQ) 
..getdtablemax(2SEQ) 
getdtablesize(2SEQ) 
setdtablesize(2SEQ) 


descriptor file entry.. 
descriptor table inde: 
descriptor table size.. 
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devbuild, devdestroy: build and 
destroy virtual devices 

virtual devices devbuild, 
ioctl: contro] 

prtvtoc: print the VTOC of a block 
print the VTOC of a standalone disk 
sp: STREAMS pipe 

or the terminal associated with a 
the terminal/ _ttydevname: get the 
diskinfo: disk 

devnm: 

clone: open any minor 

devtab: virtual 

dump kernel auto-configuration 
backup.dev: backup 

build and destroy virtual 

of virtual-to-physical mapping 

SA: 

constab: constructed 


convert between major/minor numbers/ 
blocks and inodes 

dmesg: collect system 

SCED: scsl/Ethernet/ 

terminal line connection 

bdiff: big 


comparison 
sdiff: side-by-side 
diff: 


dir: format of 

unlink: link and unlink files and 
mkdir: make 

rm, rmdir: remove files or 
uucheck: check the uucp 

cd: change working 

chdir: change working 

chroot: change root 

get pathname of current working 
system level transition files 

1s: list contents of 

mkdir: make a 

mvdir: move a 

rmdir: remove a 

uucleanup: uucp spool 

dircmp: 

dcheck: filesystem 

system independent/ getdents: read 
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..devbuild(1M) 
.devbuild(1M) 
..devbuild(1M) 


destroy virtual devices. 
devbuild, devdestroy: build and. 
devdestroy: build and destroy. 


device associated with a terminal or 
device characteristic database.. 
EVICE NAMC.csscscseassenscesssssveses 
device on a STREAMS driver 
device table... 
device table 
devices... 
devices 
devices.... 
devices administered by System Administration......... sa(7) 
devices table ..constab(4) 
devnm: device name.. .devnm(1M) 
devtab: virtual device table ..devtab(4) 
dev_to_ttyname, ttyname_to_de dev_to_ttyname(3C) 
df: report number of free disk 
diagnostic messages to form error log. 
Diagnostics board.......sssss0 
dial: establish an out-going. 
diff 
diff: differential file comparison. 
diff3: 3-way differential file. 
difference program........00 
differentia] file comparison... 
differential file comparison. 
dir: format of directories... 
dircmp: directory comparison. 
directories... 
directories... 
directories.. 


devtab(4) 
dumpconf(1M) 
backup_dev(4) 
.devbuild(1M) 


di ff3(1) 
-sdiff(1) 


«link(1M) 
..mkdir(1) 
-.-Tm(1) 
directories and permissions file... 
directory.. 
directory.. 
directory.. 
directory. 
directory .. 
directory... 
directory. 
directory... 


directory . 

directory clean-up .uucleanup(1M) 
directory comparison.. ...diremp(1) 
directory consistency check.. dcheck(1M) 
directory entries and put in a file... sssceeeeeseee getdents(2) 
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dirent: file system independent 
unlink: remove 

chroot: change root 

pwd: working 

telldir, seekdir, rewinddir/ 
seekdir, rewinddir, closedir: 
mknod: make a 

directory entry 

basename, 


instructions 

t_unbind: 

enable, 

enable, disable: enable/ 

sweepon, sweepoff: enable/ 

acct: enable or 

swapping, or processor migration 
dis386: 

dis: object code 

t_revdis: retrieve information from 
t_snddis; send user-initiated 

installs a boot program on a 

diskusg: generate 

df: report number of free 

sd: SCSI 

wd: SSM SCSI 

zd: dual-channel 

disk formatter for dual-channel 
print the VTOC of a standalone 
diskinfo: 

CCSformat: standalone embedded SCSI 
controller zdformat: standalone 
getgeombyname: get 

quotactl: manipulate 

du: summarize 

quota: display 

database 

mkvtoc: populate VTOC on 
enable/disable patrol seeks on DCC 
mgmt functions format: format 
data by user ID 
indicator: 
quota: 

vi: screen-oriented (visual) 

man: 

virtual-to-physical mapping/ pmap: 
prof: 

bootflags: 

hypot: Euclidean 


and/or the working/ 


/dbm_error, dbm_clearerr, 
messages to form error log 
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directory entry... .dirent(4) 
directory entry.... unlink(2) 
directory for a command... .chroot(1M) 
directory name.......s0 -...pwd(1) 
directory: opendir, readdir, . directory(3X) 
directory operations..........4 directory(3X) 


directory, or a special or ordinary file... 
dirent: file system independent......... 
dirname: deliver portions of pathnames.. ‘hasename() 
dis: code disassembler... ..see C and ne Tools Binder 
dis386: disassemble Series 386... 


disable LP printers. 
disable patrol seeks on 
disable process accountin; 
Disabled sescssiicsssascecssesseseseses 
disassemble Series 386 instructions. 
see C and Lang Tools Binder 
..t_revdis(3N) 
.t_snddis(3N) 
installboot(1M) 
..diskusg(1M) 
-af{1M) 


-noage(1M) 


disk accounting data by user ID. 
disk blocks and inode: 
disk controller..... 

disk controller.. 
disk controller. 
disk controller . 


disk device........ ...prtvtoc(8) 
disk device characteristic database .diskinfo(4) 
disk FOTMALLEL ...cssesessvesssscseenceseneenes .ccsformat(8) 


disk geometry by name. 
disk quotas.... 
disk usage..... 
disk usage and limits. 
diskinfo: disk device characteristi 
disks.... 
disks... 
disks or perform other defect.. 
diskusg: generate disk accounting 
display application specific alarms. 
display disk usage and limits. 
display editor based on ex... 
display on-line man pages... 
display or alter parameters of... 
display profile data.......ssssee 
display/change system boot flags 
distance function... 
ditsectbl: refresh security 

dmb_blkflush: database subroutines. 
dmesg: collect system diagnostic 
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checkeq: check 

pretmp/ chargefee, ckpacct, 
strtod, atof: convert string to 
mrand48, jrand48, srand48, seed48,/ 
open any minor device on a STREAMS 
cmpt: compatibility partitioning 

cn: pseudoconsole 

terminal multiplexor 

streampty: STREAMS pseudo terminal 
vtoc: VTOC partitioning 

Xylogics 781 terminal multiplexor 
streamtty: Generic STREAMS tty 
consmem, sm, ss: console memory 


zd: 

/standalone disk formatter for 
dump: incremental filesystem 

dump; standalone memory 

od: octal 

of an object file 

format 

dumpfs: 

dump, dumpdates: incremental 
device table dumpconf: 
savecore: save a core 


auto-configuration device table 
dump, 


descriptor 
descriptor 
dup: 
dup2: 


echo: 


floating-point number to string 


end, etext, 

command 

casual users) 

edquota: 

sact: print current SCCS file 

ed, red: text 

ex: text 

sed: stream 

vi: screen-oriented (visual) display 
ld: link 

a.out: common assembler and link 
edit: text 
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documents for correct eqn syntax...... 
dodisk, lastlogin, monacct, nulladm, 
double-precision number.......... ences 
drand48, erand48, lrand48, nrand48,. 


du: summarize disk usage. 
dual-channel disk controller. 
dual-channel] disk controller. 
dump.... 


dump, dumpdates;: incremental dump. 
dump filesystem information... 
dump format.......ssscsssssoeesees 
dump: incremental filesystem dump 
dump kernel auto-configuration........ 
dump of the operating system. 
dump: standalone memory dump.. 
dumpconf: dump kernel... 
dumpdates: incremental dump format. 
dumpfs: dump filesystem information... 
dup: duplicate an open file... 
dup2: duplicate an open file. 
duplicate an open file descriptor 
duplicate an open file descriptor 
ec: forms compiler. oa 

-echo(1) 


echo arguments... 
echo: echo arguments 6 ..echo(1) 
echo: put string on virtual output. »echo(1F) 


ecvt, fevt, gevt: convert.. 
ed, red: text editor.. 
edata: last locations in program 
ede: run an externally described. 
edit: text editor (variant of ex for... 
edit user quotas... 
editing activity. 
editor... 


editor based on ex. 
editor for object files... 
editor output. 
editor (variant of ex for casual users, 


Permuted Index 


effective user, real group, and 
/getgid, getegid: get real user, 


fsplit: split 77, ratfor, or 

using full regular expressions 
CCSformat: standalone 

printers 

acct: 

enable, disable: 

sweepon, sweepoff!: 

crypt: 

crypt, setkey, 

setkey, encrypt: generate hashing 
crypt: password and file 
makekey: generate 

program 

gence: create a front- 

/getgrgid, getgrnam, setgrent, 
setmntent: get file/ addmntent, 
bind an address to a transport 
t_close: close a transport 

at the current event on a transport 
t_open: establish a transport 
manage options for a transport 
t_unbind: disable a transport 
/getpwuid, getpwnam, setpwent, 
getspent, getspnam, setspent, 
/getutline, pututline, setutent, 
mailbug: submit a bug report or 
execution 

files 


environ: user 

putenv: change or add value to 
commands performed for multi-user 
profile: setting up an 

fpsetsticky: IEEE floating-point 

env: set 

getenv: return value for 

set, unset: set and unset 

deroff: remove nroff, tbl, and 
checkeq: check documents for correct 
jrand48, srand48, seed48,/ drand48, 
complementary error function 
complementary error function _erf, 
error messages perror, 
error function and complementary 
error function erf, erfe: 
t_revuderr: receive a unit data 
system diagnostic messages to form 
errorlog: internal 
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edquota: edit user quotas .. 
effective group IDS..........+ 
effective user, real group, and/. 
efi: Extended Fortran Language 


egrep: search a file for a pattern 
embedded SCSI disk formatter... 
enable, disable: enable/disable LP. 
enable or disable process accounting. 
enable/disable LP printers......ss000 
enable/disable patrol seeks on DCC disks.. 
encode/decode 


.enable(1) 
.acct(2) 
enable(1) 
.sweepon(1M) 
ww crypt(1) 


encrypt: generate hashing encryption... .erypt(3C) 
ENCTYPtION......ceserereseee -crypt(3C) 
encryption functions... .crypt(3X) 
encryption key......cs00 makekey(1) 


end, etext, edata: last locations in ...end(3C) 


end to the cc comMANGA..........eeereeee gencc(1M) 
endgrent, fgetgrent: get group file entry. ..getgrent(3C) 
endmntent, getmntent, hasmntopt.........getmntent(3SEQ) 


endpoint.. ..t_bind(3N) 


endpoint. _close(3N) 
endpoint. _look(3N) 
endpoint. ..t_open(3N) 
endpoint.. .t_optmgmt(3N) 
endpoint ........ .t_unbind(3N) 
endpwent, fgetpwent: get password file/. .getpwent(3C) 
endspent, fgetspent, Ickpwdf/.........00++ etspent(3X) 
endutent, utmpname, getutpid: access/ sa getut(3C) 
enhancement requeSt...cccssceseeeeeeeeses piece 


env: set environment for command.. 
.environ, .pref, .variables: FACE. 
environ: user environment.. 
environment... 
environment . 
environment.. 
environment at login time 
environment control.......... 
environment for command execution 
ENVITONMENE NAME or.sercscseeeesereereees 
environment variables in core or in files 
eqn constructs... 
eqn syntax..... 
erand48, lrand48, nrand48, mrand48, 
erf, erfc: error function and. 
erfe: error function and...... 
errno, sys_errlist, sys_nerr: system. 
error function. 
error function and complementary. 


environ(5) 
.environ(5) 
-putenv(3C) 

w+ TC2(1M) 


-erf(3M) 
.@T (3M) 
_revuderr{3N) 
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strelean: STREAMS 

strerr: STREAMS 

log: interface to STREAMS 

t_error: produce 

errormsg: 

errno, sys_errlist, sys_nerr: system 
introduction to system calls and 
matherr: 


spellin, hashcheck: find spelling 
/etc/shadow with information from / 
pwconv: installs and updates / 
end, 

SCED: scsI/ 

hypot: 

expr: 

test: condition 

t_look: look at the current 

to STREAMS error logging and 
sulog: log of substitute user 
(visual) display editor based on 
edit: text editor (variant of 


execlp, execvp: execute a file 
execlp, execvp: execute a/ exec: 
exec: execl, execv, 

exec: execl, execv, execle, execve, 
run: run an 

execle, execve, execlp, execvp: 
m_fork: 

construct argument list(s) and 

at, batch: 

regemp, regex: compile and 

uuxqt: 

env: set environment for command 
suspend and resume child process 
/system command 

sleep: suspend 

sleep: suspend 

monitor: prepare 

profil: 

execvp: execute a file exec: execl, 
exec: execl, execv, execle, 

execv, execle, execve, execlp, 


exit, 

exponential, logarithm, power/ 
uncompress, zcat: compress and 
pack, peat, unpack: compress and 
exp, log, log10, pow, sqrt: 
expression 
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.strelean(1M) 
..strerr(1M) 


error logger cleanup program 
error logger daemon... 


error logging and event tracing .....ssssssesesssereeeeeesees log(7) 
EFTOF MCSSAZE.....e.0008 t_error(3N) 
error message text file.. errormsg(4) 
error messages perror(3C) 
error numbers.. ..intro(2) 
error-handling function... -matherr(3M) 
errorlog: internal error log file. -errorlog(4) 
errormsg: error message text file. errormsg(4) 
errors... spell(1) 
etc/passwd. ..pweonv(1M) 
etc/shadow with information from/.. ..pweonv(1M) 
etext, edata: last locations in program.. ...end(3C) 
Ethernet/Diagnostics board.. .sced(7) 
Euclidean distance function... .-hypot(3M) 
evaluate arguments as an expression. -expr( 1) 
evaluation command.......... ..test(1) 
event on a transport endpoint .. look(3N) 


event tracing 
events 


ex for casual users) 
ex: text editor... 
exec: execl, execv, execle, execve, 
execl, execv, execle, execve,,. 
execle, execve, execlp, execvp: execute a 
execlp, execvp: execute a file. 


.exec(2) 
.exec(2) 


executable.. run(1F) 
execute a file. .exec(2) 
execute a subprogram in parallel m_fork(3PPS) 
execute command.... .xargs(1) 


execute commands at a later time...scsssessssessoressreseeenes at(1) 
execute regular expression... regemp(3X) 
execute remote command requests ..uuxqt(1M) 
@XOCULION ....secrcnserarcserereccsssesssscessessossecoseestoasstssasensevesiesses env(1) 
execution m_park_procs(3PPS) 
execution... .uux(1C) 
execution for an interval. sleep(1) 
execution for interval. sleep(3C) 
execution profile. «monitor(3C) 
execution time profile. profil(2) 
execv, execle, execve, execlp, exec(2) 
execve, execlp, execvp: execute a file. exec(2) 
execvp: execute a file..........4 exec(2) 
exit, _exit: terminate process. exit(2) 
_exit: terminate process... ..exit(2) 
exp, log, log10, pow, sqrt: exp(3M) 
expand data....rrcecreeeees compress(1) 
expand Nee scscccsicssrinccsnnncssenimmaancinn pack(1) 


exponential, logarithm, power, square/ 
expr: evaluate arguments as an 
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expr: evaluate arguments as an 
regex: compile and execute regular 
regemp: regular 

regexp: regular 

for a pattern using full regular 

ef: 

ede: run an 

fsplit: split 

floor, ceil, fmod, 

pathalias: alias file for 

-environ, .pref, .variables: 

report inter-process communication 
a number 

factor: obtain the prime 

true, 

abort: generate an IOT 

stream 


number to string ecvt, 
fopen, freopen, 
ferror, 
stream status inquiries 

for a filesystem 

felose, 

from a stream gete, getchar, 
/getgrnam, setgrent, endgrent, 
/getpwnam, setpwent, endpwent, 
gets, 

/getspnam, setspent, endspent, 
string 

cut: cut out selected 

mk fifo: make a 

access: determine accessibility of a 
chmod: change mode of 

chown: change owner and group of a 
core: format of core image 

cronlog: cron history 

crontab: user crontab 

crontabs: clock daemon 

ctags: create a tags 

selected fields of each line of a 

dd: convert and copy a 

make a delta (change) to an SCCS 
errorlog: internal error log 
errormsg: error message text 
execve, execlp, execvp: execute a 
get: get a version of an SCCS 

group: group 

issue: issue identification 

header of a member of an archive 
Idaclose: close a common object 
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expression... 
expression..... 
expression compile. 
expression compile and match routines 


OXPTESSIONS.........sceeseeeeseecvereren: egrep(1) 
Extended Fortran Language oe @fl(1) 
externally described command dc(1M) 
£77, ratfor, or eff files............00 fsplit(1) 
fabs: floor, ceiling, remainder, absolute value floor(3M) 
FACE........ alias(4) 


FACE files.. 
facilities status. 
factor: obtain the prime factors of... 
factors of a numbeF.........000+ 


_ -ipes(1) 
.factor(1) 
-factor(1) 


fclose, flush: close or flush a. 
fentl: file control... 
fentl: file control options.. 
fevt, gcvt: convert floating-point... 
fdopen: open a stream.....sser 
feof, clearerr, fileno: stream status inquiries.. 
ferror, feof, clearerr, fileno:... 
ff: list filenames and statistics.. 
fflush: close or flush a stream... 
fgetc, getw: get character or word.. 
fgetgrent: get group file entry...... 
fgetpwent: get password file entry. 
fgets: get a string from a stream. 
fgetspent, Ickpwdf, ulckpwdf: get/.. 
fgrep: search a file for a character.. 
fields of each line of a file...... 
FIFO special file. 
file... 


.-fentl(2) 
...fentl(5) 


“ge spent(3X) 
grep(1) 
.cut(1) 
.mk fifo(3C) 
access(2) 
chmod(2) 
....chown(2) 


GE Fassia cesses sctacant sess atstasssesscscesavwaswaswcstvastsdcescasscesiasesnecace core(4) 
file .cronlog(4) 
file. .crontab(1) 


file sai “ad(1M) 
HU Os sssscsnssessassoncsessvsesecssasceserscssccacssecedsasssonsosescescsseasooreress delta(1) 
file errorlog(4) 


..errormsg(4) 
+-exec(2) 


..Idelose(3X) 
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the file header of a common object 
of a section of a common object 

file header of a common object 

of a section of a common object 
section header of a common object 
section of a common object 

table entry of a common object 
table entry of a common object 

the symbol table of a common object 
number entries in a common object 
link: link to a 

mkfifo: make a FIFO special 

mknod: build special 

directory, or a special or ordinary 
format of a module configuration 
motd: message-of-the-day 

newform: change the format of a text 
null: the null 

passwd: password 

files or subsequent lines of one 
product: installed products 

prs: print an SCCS 

resfile: format of RCS 

read: read from 

readv: read vector from 

reinit: run an initialization 
information for a common object 
rename: change the name of a 
rmdel: remove a delta from an SCCS 
compare two versions of an SCCS 
scesfile: format of SCCS 

scestorcs: build RCS file from SCCS 
section header for a common object 
format of curses screen image 
shadow: restricted password 

system shutdown information 
spellhist: unmatched spelling words 
print checksum and block count of a 
symlink: make symbolic link to a 
format of a system configuration 
tail: deliver the last part of a 

term: format of compiled term 
tmpfile: create a temporary 

create a name for a temporary 
access and modification times of a 
undo a previous get of an SCCS 
uniq: report repeated lines in a 
add/delete users in utmp 

the uucp directories and permissions 
val: validate SCCS 

write: write ona 

writev: write vector on a 
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.mod_config(4) 
..motd(4) 
..newform(1) 


.secsfile(4) 
.secstorcs(1) 


-writev(2SEQ) 
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utime: set 

ldfen: common object 
readfile, longline: reads 
cpset: copy 

Hewlett-Packard 2645A terminal tape 
tar: tape 

cpio: copy 

res: change RCS 

pwek, grpck: password/group 
mcs: manipulate the object 
diff: differential 

diff8: 3-way differential 
fentl: 

fentl: 

UNIX-to-UNIX system 
umask: set and get 

close: close a 

dup: duplicate an open 

dup2: duplicate an open 


sact: print current SCCS 

crypt: password and 

endgrent, fgetgrent: get group 

get file system descriptor 
endpwent, fgetpwent: get password 
ulckpwdf: get shadow password 
utmpname, getutpid: access utmp 
putpwent: write password 
putspent: write shadow password 
fgrep: search a 

grep: search a 

egrep: search a 

proto: prototype job 

pathalias: alias 

Idaopen: open a common object 
acct: per-process accounting 

ar: common archive 

manager, updates text files in ISIS 
intro: introduction to 

scestorcs: build RCS 

number entries of a common object 
filehdr: 

limits: 

unistd: 

ldfhread: read the 

ldohseek: seek to the optional 
split: split a 

mmap: map an open 
isismgr: ISIS 
merge: three-way 
ttyslot: find the slot in the utmp 
more: view a 


ISIS file format 
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file access and modification times. 
file access routines....... 
file and gets longest line. 
file and set mode, user, and group IDs.. 
file archiver... 
file archiver.. 
file archives in and out. 
file attributes... 
file checkers... 
file comment section. 
file comparison....... 
file comparison 
file control......+ 
file control options 
file copy.. 
file creation mask... 
file descriptor.. 
file descriptor... 
file descriptor:........0-010 
file: determine file type 
file editing activity.... 
file encryption functions. 
file entry... 
file entry. 
file entry... 
file entry... 


file entry... 
file for a character string 
file for a pattern ...c..cecese 


file for a pattern using full regular expressions 


file for at...... 
file for FACE 
file for reading.. 


; ..1dfen(4) 
..readfile(1F) 


-dup(2) 
..dup2(2) 
.file(1) 
sact(1) 
erypt(3X) 
dssived getgrent(3C) 
etmntent(3SEQ) 
..getpwent(3C) 
getspent(3X) 
eer getut(3C) 
..putpwent(3C) 


file format....sscceecccserecessesssensssesssesseaseseenssrescesonssenorses acct(4) 
file format see C and Lang Tools Binder 
file format. -isismgr(1M) 
file formats.......scccssssssscscserssssoessecsssseessssactssssasecensesroree intro(4) 
file from SCCS fil scestorcs(1) 
file function......... dlread(3X) 
file header for common object files.. filehdr(4) 
file header for implementation-specific/. .-limits(4) 
file header for symbolic constants... sees nistd(4) 
file header of a common object fil ldfhread(3X) 
file header of a common object file... Idohseek(3X) 


file into pieces. 
file into the processs a: 88 Space.. 
file manager, updates text files in 
file merge.. 
file of the current user. 
file one full screen at a time... 
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fuser: identify processes using a 
creat: create a new 

Pg: 

lseek: move read/write 

fseek, rewind, ftell: reposition a 
bfs: big 

from a two to a one password 

stat, Istat, fstat: get 

identify processes using a file or 
symbol name for common object 
syms: common object 

newfs: construct a new 

/read directory entries and put ina 
/getmntent, hasmntopt, setmntent: get 
dirent: 

fs, inode: format of 

truncate, ftruncate: truncate a 
uusched: the scheduler for the uucp 
uucico: 

ftw: walk a 

file: determine 

umask: set 

object files 

mktemp: make a unique 

search Interpreter criteria for 
ctermid: generate 

ff: list 

ferror, feof, clearerr, 

search and print process accounting 
merge or add total accounting 
admin: create and administer SCCS 
cat: concatenate and print 

cmp: compare two 

or reject lines common to two sorted 
config: build system configuration 
cp, In, mv: copy, link or move 
.environ, .pref, .variables: FACE 

file header for common object 

find: find 

fspec: format specification in text 
fsplit: split £77, ratfor, or efi 

string, format of graphical 

ident: identify 

intro: introduction to special 

lockf: record locking on 

makedev: make system special 
peat, unpack: compress and expand 
pr: print 

and other information about RCS 
environment variables in core or in 
sort: sort and/or merge 

uucp: networking support 
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file or file structure. 
file or rewrite an existing one. 
file perusal filter for CRTs. 


file pointer 

file pointer in a stream. “feeek(3S) 
Pil@ SCANS cscacsescesccvenssesecesuncesstsesascanaaaaseuaveeseaceineeiees eats bfs(1) 
file scheme. ..pwunconv(1M) 
VL SEB GUL tessacacscscaapeasdacevecccuiars tescgeacestanssteanaiareeaaciescnsteed| stat(2) 
file structure.. fuser(1M) 
file symbol table entry. ..ldgetname(3X) 
file symbol table format 

file SYBtOM .0..,...csseceseeeeeees .-newfs(1M) 


.getdents(2) 
getmntent(83SEQ) 
.dirent(4) 


file system independent format.. 
file system descriptor file entry... 
file system independent directory entry.. 
file system volume 
file to a specified length. 
file transport program......... eee eer uusched(1M) 
file transport program for the uucp system........uucico(1M) 
file tree... 
file type... 
file-creation mode mask 
filehdr; file header for common 


"mktemp(3C) 
pathconv(1F) 


filenames and statistics for a filesystem .....scsssessseees (1M) 
fileno: stream status inquiries.. ..ferror(3S) 
files... .acctcom(1) 
files. «.acctmerg( 1M) 


Permuted Index 


what: identify SCCS 

link, unlink: link and unlink 
init.d: system level transition 
ISIS file manager, updates text 
passmgmt: password 

rm, rmdir: remove 

paste: merge same lines of several 
ott: 

checkfsys: check a 

list filenames and statistics for a 
mkfs: construct a 

mount: mount a 

repquota: summarize quotas for a 
tunefs: tune up an existing 
umount: unmount a 

volcopy: make literal copy of 
ckbupscd: check 
fsck: 

dcheck: 

dump: incremental 
fstyp: determine 
dumpfs: dump 
statfs, fstatfs: get 
quotacheck: 
quotaon, quotaoff: turn 

restore: incremental 

ustat: get 

fsstat: report 

icheck: 

mnttab: mounted 

labelit: provide labels for 

mount, umount: mount and unmount 
umountall: mount, unmount multiple 
checklist: list of 

fstab: 

greek: select terminal 

nl: line numbering 

pg: file perusal 

col: 

Ipfilter: administer 


interactive repair 


for an object library lorder: 
display/change system boot 
/fpgetsticky, fpsetsticky: IEEE 
isnan: isnand, isnanf: test for 

ecvt, fevt, gevt: convert 

ldexp, modf: manipulate parts of 
ceiling, remainder, absolute value/ 
floor, ceil, fmod, fabs: 

felose, fflush: close or 

a co-process with the controlling 
floor, ceil, 
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files... 
files and directories.. 


files in ISIS file format. 
files management .. 
files or directories. 


files or subsequent lines of one/.. .-paste(1) 
files that hold object architecture information... ..0tt(4) 
filesystem... ..checkfsys(1M) 
FileBYSLEM......ccsorrercsocorescscscsoassvesesesesecesncnanszerernseseressrecaes ff(1M) 
filesystem mkfs(1M) 
FiCSYSLOM......scsecssssessnssesnscsssscncnsersnsersesseeeeseonoeesencaes mount(2) 
filesystem. repquota(1M) 
filesystem. .tunefs(1M) 
filesystem -umount(2) 
filesystem ..volcopy(1M) 


kbupscd(1M) 
fsck(1M) 
...dcheck(1M) 
.dump(1M) 
.-fstyp(1M) 
..dumpfs(1M) 
acvicaed statfs(2) 
..quotacheck(1M) 


filesystem backup schedule 
filesystem consistency check and. 
filesystem directory consistency check.. 
filesystem dump.... 
filesystem identifier. 
filesystem information 
filesystem information. 
filesystem quota consistency checker 
filesystem quotas on and off. 
filesystem restore..... 
filesystem statistics.. 
filesystem status........ 
filesystem storage consistency check . 
filesystem table. 
filesystems... 
filesystems... 
filesySteMs......csseeeeerereee 

filesystems processed by fsck and ncheck. 
file-system-table 


filter for CRTs... 
filter reverse line-feeds. 
filters used with the LP print service... 
find: find files 
find ordering relation... 
flags 
floating-point environment control... 
floating-point NaN (Not-A-Number).. 
floating-point number to string 
floating-point numbers... 
floor, ceil, fmod, fabs: floor,. 
floor, ceiling, remainder, absolute value/.. 
flush & StreaM......ssccsssssessssessnesnesessceeneeee ..fclose(3S) 
FMLI ObjeCt....sessssscesssssesessssensensessnerenssceeceneeen -vsig( 1F) 
fmod, fabs: floor, ceiling, remainder, absolute’ .....floor(3M) 
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stream 


tegetpgrp: get 
tcesetpgrp: set 


system diagnostic messages to 

reset: reset the current 

acct: per-process accounting file 
dump, dumpdates: incremental dump 
put in a file system independent 
updates text files in ISIS file 
common object file symbol table 
management functions format: 
other defect management functions 
mod_config: 

sys_config: 

newform: change the 


fs, inode: 

gps: graphical primitive string, 
resfile: 

sccsfile: 

fapec: 

strftime: 

intro: introduction to file 

utmp, wtmp: utmp and wtmp entry 
scanf, fscanf, sscanf: convert 
printf, fprintf, sprintf: print 
vprintf, vfprintf, vsprintf: print 
pwfix: remove incorrectly 
standalone embedded SCSI disk 
zdformat: standalone disk 
ASSIST menus or command 
ec: 

lIpforms: administer 
addformopt: add a 

ratfor: rational 

efi: Extended 

pathconf, 

fpgetround, fpsetround, 
fpsetmask, fpgetsticky/ 
/fpsetround, fpgetmask, fpsetmask, 
printf, 

fpgetround, fpsetround, fpgetmask, 
fpgetsticky,/ fpgetround, 
/fpgetmask, fpsetmask, fpgetsticky, 
pute, putchar, 

puts, 

getfrm: returns the current 


variables 
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fopen, freopen, fdopen: open a... 
foreground process group ID.... 
foreground process group ID. 
fork: create a new process. 
form error Og......cscscsseceseee 
form field to its default values... 


fopen(3S) 
.tegetpgrp(2) 
pa 


format disks or perform other defect. 
format: format disks or perform....... 
format of a module configuration file.. 
format of a system configuration file 
format of a text file.......sese0e 


“mod | config(4) 
sys_config(4) 
..newform(1) 


format of core image file... 
format of cpio archive... 
format of curses screen image file 
format of directories..........0 
format of file system volume . 


format of graphical files.. -gps(4) 
format of RCS file... resfile(4) 
format of SCCS file... scesfile(4) 


format specification in text files 
format time information. 


formats... -intro(4) 
formats... .utmp(4) 
formatted input.. scanf(3S) 
formatted output... -printf(3S) 
formatted output of a varargs/.. vprintf(3S) 
formatted password entries pwfix(1M) 
FOV ALCOR scccceusiesensscescecsacncssies ccsformat(8) 


formatter for dual-channel disk/.. 


forms compiler 
forms used with the LP print service. 
form/SELECT window option to a menu. 
Fortran dialect.... 
Fortran Language. 
fpathconf: get configurable pathname 
fpgetmask, fpsetmask, fpgetsticky/.... 
fpgetround, fpsetround, fpgetmask, 
fpgetsticky, fpsetsticky: IEEE/........ 
fprintf, sprintf: print formatted output... 
fpsetmask, fpgetsticky, fpsetsticky/ 
fpsetround, fpgetmask, fpsetmask 
fpsetsticky: IEEE floating-point/... 
fputc, putw: put character or word on a stream save putce(3S) 
fputs: put a string on a stream.. ... puts(3S) 
frame number getfrm(1F) 


~.pathcon{{2) 
getround(3C) 
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t_free: 

df; report number of 

malloc, 

mallinfo: fast main memory/ malloc, 
fopen, 

of floating-point numbers 
gence: create a 

volume 

scanf, 

list of filesystems processed by 
and interactive repair 

file pointer in a stream 
generation numbers 

files 

files 


stat, Istat, 

statfs, 

identifier 

fseek, rewind, 

communication package stdipe: 
specified length truncate, 


function and complementary error 
gamma: log gamma 

hypot: Euclidean distance 

entries of a common object file 
matherr: error-handling 

prof: profile within a 

erf, erfc: error 

50, j1, jn, yO, y1, yn: Bessel 

crypt: password and file encryption 
logarithm, power, square root 
ceiling, remainder, absolute value 
or perform other defect management 
sinh, cosh, tanh: hyperbolic 

sysi86: machine specific 

keys to internal menu system 
acos, atan, atan2: trigonometric 
math: math 

intro: introduction to 

300, 300s: handle special 

“hp: handle special 

460: handle special 

file or file structure 

specified controlling terminal 
fread, 

accounting records 

gamma: log 
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fread, fwrite: binary input/output 
free a library structure....... 
free disk blocks and inodes. 
free, realloc, calloc: main memory allocator. 
free, realloc, calloc, mallopt,. 
freopen, fdopen: open a stream.. 
frexp, ldexp, modf: manipulate parts.. 
front-end to the cc command. 
fs, inode: format of file system. 
fscanf, sscanf: convert formatted input... 
fsck and ncheck 
fsck: filesystem consistency check 
fseek, rewind, ftell: reposition a. 
fsirand: install random inode... 
fspec: format specification in text. 
faplit: split {77, ratfor, or eff...... 
fsstat: report filesystem status... 
fatab: file-system-table 
fatat: get file status....... 
fstatfs: get filesystem information... 
fstyp: determine filesystem. 
ftell: reposition a file pointer in a stream. 
ftok: standard interprocess..... 
ftruncate: truncate a file to a. 
ftw: walk a file tree 


"“checklist(4) 
..fsck(1M) 
..fseek(3S) 
.fsirand(1M) 
.fspec(4) 
fsplit(1) 
fsstat(1M) 


..fstyp(1M) 
fseek(3S) 
.stdipe(8C) 
.tru ie 


function. 
function.. 
function. 
function. 
function and complementary error function. 
functions... 


functions -exp(3M) 
functions .-floor(3M) 
functions ..format(1M) 
functions... ..3inh(3M) 
functions... ..3y3i86(2) 
functions vsyskeymap(4) 
functions .. ...trig(3M) 


functions and constants... 
functions and libraries, 
functions of DASI 300 and 300s terminals 
functions of Hewlett-Packard terminals... 
functions of the DASI 450 terminal. 
fuser: identify processes using a.. 
fvhangup: virtually hangup the 


-math(5) 


fwrite: binary input/output....... ..fread(3S) 
fwtmp, wtmpfix: manipulate connect. fwtmp(1M) 
gamma function.........000 .gamma(3M) 


gamma: log gamma function.. ....gamma(3M) 


DYNIX/pix Reference Manual 


Permuted Index 


ecvt, fevt, 

command 

command forms astgen: program for 
fsirand: install random inode 

rand, srand: simple random-number 
streamtty: 

tty: controlling terminal 
getgeombyname: get disk 

character or word from a stream 

or word from a stream getc, 
working directory 

put ina file system independent/ 
descriptor table index 


size 

getuid, geteuid, getgid, 

name 

user, effective user, real/ getuid, 
number 


geometry by name 
getuid, geteuid, 
setgrent, endgrent, fgetgrent: get/ 


endgrent, fgetgrent: get/ _getgrent, 
fgetgrent: get/  getgrent, getgrgid, 
IDs 


currently marked menu items 


file system/ addmntent, endmntent, 
stream 
argument vector 


getopts, 
options 


process group, and parent/ __getpid, 
process, process group, and parent/ 
and parent process/ getpid, getpgrp, 
utilization information 


setpwent, endpwent, fgetpwent: get/ 
fgetpwent: get/ getpwent, getpwuid, 
endpwent, fgetpwent: get/ getpwent, 
stream 

readfile, longline: reads file and 
scsiinfo structure 

getscsiinfo, 

endspent, fgetspent, Ickpwdf/ 
fgetspent, lckpwdf/ getspent, 
speed and terminal settings used by 
speed, and line discipline 

ct: spawn 
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gevt: convert floating-point number to string......... 
gence; create a front-end to the cc... 
generating/modifying ASSIST menus or.. 
generation numbers... 
BENCTALOL .......eceeessore 
Generic STREAMS tty driver interface. 
(gentty) interface... 
geometry by name. 
gete, getchar, fgetc, getw: get.. 
getchar, fgetc, getw: get character.. 
getcwd: get pathname of current... 
getdents: read directory entries and. 
getdtablemax: get max in-use. getdtablemax(2SEQ) 
getdtablesize: get descriptor table...... managed oe 
getegid: get real user, effective user, real/ 
getenv: return value for environment... 
geteuid, getgid, getegid: get real.. 
getfrm: returns the current frame 


“feirand( 1M) 
..rand(3C) 
streamtty(7) 


~ getgeombyname(3SEQ) 
+ gete(3S) 


getgeombyname: get disk/.............. getgeombyname(3SEQ) 
getgid, getegid: get real user, effective user/........getuid(2) 
getgrent, getgrgid, getgrnam,... getgrent(3C) 
getgrgid, getgrnam, setgrent,. getgrent(3C) 
getgrnam, setgrent, endgrent, .. ..getgrent(3C) 
getgroups: get supplementary group .. getgroups(2) 
getitems: returns a list of the. getitems(1F) 
getlogin: get login name......... ...getlogin(3C) 
getmntent, hasmntopt, setmntent: get “getmntent(3SEQ) 


on getmsg(2) 
getopt(3C) 
..getopt(1) 
-getopts(1) 
-getopts(1) 
getpagesize(2SEQ) 
-getpass(3C) 
..getpid(2) 
getpid(2) 


getmsg: get next message offa. 
getopt: get option letter from. 
getopt: parse command options. 
getoptcvt: parse command option 
getopts, getoptcvt: parse command.. 
getpagesize: get system page size 
getpass: read a password... 
getpgrp, getppid: get process, 
getpid, getpgrp, getppid: get.. 


getppid: get process, process group,.. getpid(2) 
get_process_stats: get resource ....get_process_stats(2SEQ) 
getpseudotty: get pseudo terminala.....getpseudotty(3SEQ) 
getpw: get name from IUD.....cssssssssssscssesssnsesseesees getpw(3C) 
getpwent, getpwuid, getpwnam,, .getpwent(3C) 
getpwnam, setpwent, endpwent,... .getpwent(3C) 
getpwuid, getpwnam, setpwent, .getpwent(3C) 


gets, fgets: get a string from a. gets(3S) 
gets longest lime.........ccecseees adfile(1F) 
getscsiinfo, getscsimatch: get. .getscsiinfo(3SEQ) 
getscsimatch: get scsiinfo structure.........getscsiinfo(3SEQ) 
getspent, getspnam, setspent,.... ..getspent(3X) 
getspnam, setspent, endspent, getspent(3X) 
LOLLY: casesncscessnssessesesassesoossenaseasares .gettydefs(4) 
getty: set terminal type, modes, .getty(1M) 


getty to a remote terminal 


Permuted Index 


settings used by getty 

get real user, effective user, real/ 
microsecond clock 

pututline, setutent, endutent/ 
pututline, setutent/ getut: 
getut: getutent, 

getut: getutent, getutid, 

/setutent, endutent, utmpname, 
getc, getchar, fgetc, 

zdinfo structure 

getzdinfo, 

m_next: increment 

task: 

operating system terms and symbols 
mktime, tzset/ ctime, localtime, 
setjmp, longjmp: non-local 

format of graphical files 

primitive string, format of 

of graphical files gps: 
plot: 

plot: 


chown, chgrp: change owner or 
newgrp: log in to a new 

run command in its own process 
initgroups: initialize 

setgroups: set 

/get real user, effective user, real 
/getppid: get process, process 
group: 

pwek, grpck: password/ 

setgrent, endgrent, fgetgrent: get 


setpgrp: set process 

create session and set process 
tegetpgrp: get foreground process 
tesetpgrp: set foreground process 
copy file and set mode, user, and 
getgroups: get supplementary 
user, real group, and effective 
setuid, setgid: set user and 

id: print user and 

groups: show 

chown: change owner and 

send a signal to a process or a 
maintain, update, and regenerate 


pwek, 
ssignal, 
stty, 


terminal fvhangup: virtually 
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..gettydefs(4) 
....getuid(2) 
getusclk(3SEQ) 
getut(3C) 


gettydefs: speed and terminal. 
getuid, geteuid, getgid, getegid: 
getusclk, usclk_init: get/init..... 
getut: getutent, getutid, getutline, 


getutent, getutid, getutline, ..getut(3C) 
getutid, getutline, pututline, setutent/ getut(3C) 
getutline, pututline, setutent, endutent/.. getut(3C) 
getutpid: access utmp file entry... getut(3C) 


getw: get character or word from a stream. ».getce(3S) 
getzdinfo, getzdinfobyname: get... getzdinfo(3SEQ) 
getzdinfobyname: get zdinfo structure......getzdinfo(3SEQ) 
global counter -m_next(3PPS) 
global security table 
glossary: definitions of common 
gmtime, asctime, cftime, ascftime,. 


gps: graphical primitive string, 
graphical files. 
graphical primitive string, format.. 
graphics interface ....cccecrseeeeeees 
graphics interface subroutines. 
greek: select terminal filter... 
grep: search a file for a pattern 
group. 
group.. 
group. 
group access list 
group access list 
group, and effective group IDs... 
group, and parent process IDs.. 


wacaets setpgrp(1) 
nitgroups(3SEQ) 


Group file.....eceseeee 

group file checkers. 

group file entry... getgrent(3C) 
group: group file.. ..group(4) 
group ID... .setpgrp(2) 
group ID .setsid(2) 
group ID .tegetpgrp(2) 
group ID ..tesetpgrp(2) 
QTOUP IDB......-.sccccscerseseesasasesosecscssenssrsveonsgensnnsssacersssessess epset(1) 
group IDs. .getgroups(2) 
group ID: .-getuid(2) 
group IDs... setuid(2) 
group IDs and names id(1M) 
group memberships... groups(1) 
group of a file...... chown(2) 
QTOUP Of POCESSES.......rescercnssssennerncsnecerencsenesnenneesoeeatennean kill(2) 
Groups Of Programs .....sesecsseeresesveees -make(1) 
groups: show group memberships 


groups(1) 


grpck: password/group file checkers. 
gsignal: software signals. 
gtty: set and get terminal state (defunct). 
hangup the specified controlling.........-..-. 
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nohup: run a command immune to 
hsearch, hcreate, hdestroy: manage 
spell, hashmake, spellin, 

crypt, setkey, encrypt: generate 
spelling errors spell, 
addmntent, endmntent, getmntent, 
search tables hsearch, 
hsearch, hcreate, 

senhdr: section 

filehdr: file 

limits: file 

unistd: file 

ldfhread: read the file 

ldohseek: seek to the optional file 
/read an indexednamed section 
ldahread: read the archive 

helplog: monitor 

help: operating system 

helpadm: change the 


database 


file archiver hpio: 
hp: handle special functions of 
cronlog: cron 

ott: files that 

uptime: show 

Hewlett-Packard terminals 

tape file archiver 

hash search tables 

sinh, cosh, tanh: 


u3b5, vax: get processor/ machid: 
consistency check 


m_get_myid: return process 

issue: issue 

fstyp: determine filesystem 

shmget: get shared memory segment 
file and set mode, user, and group 
getgroups: get supplementary group 
process group, and parent process 
real group, and effective group 
setuid, setgid: set user and group 

id: print user and group 

/fpsetmask, fpgetsticky, fpsetsticky: 
core: format of core 

scr_dump: format of curses screen 
crash: examine system 

limits: file header for 

pwfix: remove 

m_next: 
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hangups and quits... 


hash search tables 

hashcheck: find spelling spell(1) 
hashing encryption ......s.sssss00 erypt(3C) 
hashmake, spellin, hashcheck: find.. ... 8pell(1) 
hasmntopt, setmntent: get file/. .getmntent(3SEQ) 
hcreate, hdestroy: manage hash... hsearch(3C) 
hdestroy: manage hash search tables. hsearch(3C) 
header for a common object file... senhdr(4) 
header for common object files....... filehdr(4) 


header for implementation-specific constants.. 
header for symbolic constants... 
header of a common object file.. 
header of a common object file .. 
header of a common object fil 
header of a member of an archive 
help actions... 
Help Facility. 
Help Facility database 
help: operating system Help Facility.. 
helpadm: change the Help Facility.. 
helplog: monitor help actions........... 
Hewlett-Packard 2645A terminal tape... 
Hewlett-Packard terminals 


..ldohseek(3X) 
.-ldshread(3X) 
.-ldahread(3X) 


hold object architecture information 
how long system has been up... 
hp: handle special functions of... 
hpio: Hewlett-Packard 2645A terminal .. 
hsearch, hcreate, hdestroy: manage 
hyperbolic functions ........cccseeeees 
hypot: Euclidean distance function. 
i386, ns32000, pdp11, u3b, u3b2,.. 
icheck: filesystem storage... 
ident: identify files 
identification... 
identification file 
identifier... 


“icheck(1M) 
.-ident(1) 
-m_get, a eh 


IDs and names. 
IEEE floating-point environment/. 
image file. 
image file . 
images... 
implementation-specific constant 
incorrectly formatted password entries... 
increment global counter. 


Permuted Index 


dump, dumpdates: 

dump: 

restore: 

get maximum in-use descriptor table 
common/ ldtbindex: compute the 
common object/ _Idtbread: read an 
commontdshread, Idnshread: read an 
ldsseek, ldnsseek: seek to an 

receipt of an orderly release 

receive a unit data error 

specific alarms and/or the working 
specific alarms anW/or the working/ 
calculate number of blocks and 
syscall: 

terminfo descriptions 

getusclk, usclk_init: get/ 

inittab: script for the 

initialization 

files directory 

list 

init, telinit: process control 

rejnit: run an 

bcheckre: system 

tput: 

s_init_barrier, s_wait_barrier: 
initgroups: 

/s_lock, s_clock, s_unlock: 

setup: 


clri: clear 

fs, 

fsirand: install random 

number of free disk blocks and 
facanf, sscanf: convert formatted 
ungetc: push character back into 
fread, fwrite: binary 

poll: STREAMS 

stdio: standard buffered 

uustat: uucp status 

install: 


fsirand: 

onthe BOM _ bomverify: perform an 
on a disk 

product: 

installboot: 

with information from/ pweonv: 
dis386: disassemble Series 386 
mailx: 

filesystem consistency check and 
console: console 

lp: Systech parallel line printer 
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incremental dump format... 
incremental filesystem dum; 
incremental filesystem restore 


"getdtablemax(2SEQ) 
Idtbindex(3X) 
..ldtbread(3X) 
.ldshread(3X) 
«.-ldsseek(3X) 
..t_revrel(3N) 
.t_revuderr(3N) 
-indicator(1F) 
.indicator(1F) 
imp | 


index of a symbol table entry of a.. 
indexed symbol table entry of a.. 
indexednamed section header of a. 
indexednamed section of a common/. 
indication.... 
indication 
indicator. 
indicator: display application... 
indirect blocks........0« 
indirect system call. 
infocmp: compare or print out. 
init microsecond clock. 
Init PPOCESB....sseereereeees 
init, telinit: process control.. 
init.d: system level transition. 
initgroups: initialize group access. 
initialization......... 
initialization file... reinit(1F) 
initialization procedures... -bcheckre(1M) 
initialize a terminal or query terminfo database.....tput(1) 
initialize barrier, wait at barrie s_wait_barrier(3PPS) 
initialize group access list ....initgroups(3SEQ) 
initialize, lock, unlock locks. s_lock(3PPS) 
initialize system for first user. ...Setup(1) 
inittab: script for the init proces: -inittab(4) 
IN0de ...seseeeee 
inode: format of file system volume... 
inode generation numbers 
inodes.. 
input..... 
input stream... 


initgroups(3SEQ) 
.-init(1M) 


....scan{(3S) 
..ungete(3S) 


input/output.. .fread(3S) 
input/output multiplexing......scsseceseeesrercsseseesaeeaees poll(2) 
input/output PACkAage...ecsecocssscnseneensssessnesscenssneeseeseren stdio(3S) 
inquiry and job control.. ..uustat(1C) 
install commands........... 

install: install commands..........00+ 


install random inode generation numbers. 
installation consistency check based... 
installboot: installs a boot program.. 
installed products file. 
installs a boot program on a disk 
installs and updates /etc/shadow 
{MSETUCCIONS ....cscsssseereseeererecenseneneeseee 
interactive message processing system. 
interactive repair 
interface... 
interface .. 


.-bomverify(1M) 
.installboot(1M) 


product(4) 
-installboot(1M) 
.«.pweonv( 1M) 
dis386(3SEQ) 
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mtio: UNIX magnetic tape 

plot: graphics 

Generic STREAMS tty driver 

swap: swap administrative 

termio: general terminal 

tg: SCSI 1/2-inch magnetic tape 

tty: controlling terminal (gentty) 
wp: SSM parallel line printer 
Xylogics 472 MULITBUS magnetic tape 
timod: Transport 

STREAMS module _tirdwr: Transport 
Transport Interface read/write 

plot: graphics 

sysadm: menu 


and event tracing log: 
errorlog: 

syskeymap: identify keys to 

asa: 


pathconv: search 

csh: a shell (command 

pipe: create an 

ipes: report 

stdipc: ftok: standard 

tfipe: 

ncheck: generate pathnames from 
streamio: STREAMS 


abort: generate an 

semaphore set, or shared memory ID 
communication facilities status 
/isxdigit, islower, isupper, isalpha, 
isdigit, isxdigit, islower, isupper, 
Ascntrl, ispunct, isprint, isgraph, 
ttyname, 

/isupper, isalpha, isalnum, isspace, 
isalpha, isalnum, isspace, iscntrl/ 
fisspace, iscntrl, ispunct, isprint, 

file manager, updates text files in 
files in ISIS file format isismgr: 
text files in ISIS file format 

isdigit, isxdigit, 

floating-point NaN (Not-A-Number) 
isnan: 

(Not-A-Number) isnan: isnand, 
/isalnum, isspace, iscntr], ispunct, 
/isalpha, isalnum, isspace, iscntrl, 
Jislower, isupper, isalpha, isalnum, 


isdigit, isxdigit, islower, 
isalnum, isspace, isentrl/ isdigit, 


getpw: get name from 
bessel: 
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..-Datio(7) 
-plot(4) 
streamtty(7) 


interface... 
Interface cooperating STREAMS module 
Interface read/write interface... 

interface STREAMS module... 
interface subroutines........ 
interface to do system administration. 
interface to STREAMS error logging. 
internal error log file... 
internal menu system functions... 
interpret ASA carriage control characters 
Interpreter criteria for filename.... 
interpreter) with C-like syntax. 
interprocess channel... 
inter-process communication facilities status. 
interprocess communication package.. 
interprocess communication reporter . 
i-numbers ncheck(1M) 
..8treamio(7) 
-wioct](2) 
..abort(3C) 


ioctl: control device. 
IOT fault 
iperm: remove a message queue, .. 
ipes: report inter-process.......00 
isalnum, isspace, iscntrl, ispunct,/ 
isalpha, isalnum, isspace, iscntrl/... 
isascii, tolower, toupper, toascci/.. 
isatty: find name of a terminal. 
iscntrl, ispunct, isprint, isgraph/.. 
isdigit, isxdigit, islower, isupper,.. 
isgraph, isascii, tolower, toupper,/ 
ISIS file format 
ISIS file manager, updates text.. 
isismgr: ISIS file manager, updates... 
islower, isupper, isalpha, isalnum, isspace,/. 
isnan: isnand, isnanf: test fOr.......s.ssssesseees 
isnand, isnanf; test for floating-point NaN/.. 
isnanf: test for floating-point NaN. 
isprint, isgraph, isascii, tolower/.. 
ispunct, isprint, isgraph, isascii/... 
isspace, iscntrl, ispunct, isprint//. 
issue identification file ...........0 
isupper, isalpha, isalnum, isspace/. 
isxdigit, islower, isupper, isalpha, 


“isismgr( 1M) 
-isismgr( 1M) 
-isismgr( 1M) 


Permuted Index 


bessel: j0, 

bessel: jO, j1, 

uustat: uucp status inquiry and 
proto: prototype 


/erand48, lrand48, nrand48, mrand48, 
sigsetjmp, siglongjmp: non-local 
dumpconf: dump 

makekey: generate encryption 
syskeymap: identify 

apropos: locate commands by 

system command locate: use 
killall: 

m_kill_procs: 

a group of processes 


mem, 
kMBmem, 

ksh, rksh: 

standard/restricted command and/ 
integers and long integers 

and base-64 ASCII string a64l, 
filesystems 

labelit: provide 

awk: pattern scanning and processing 
be: arbitrary-precision arithmetic 

efl: Extended Fortran 

command and programming 

pattern scanning and processing 
command programming 

cftime: 

chargefee, ckpacct, dodisk, 

/setspent, endspent, fgetspent, 
/mrand48, jrand48, srand48, seed48, 
files 


Idclose, 

a member of an archive file 

for reading ldopen, 
object file 


floating-point numbers frexp, 
routines 
common object file 

common object file symbol table/ 
number entries of a common/Idlread, 
entries of a/ Idlread, Idlinit, 
manipulate line number entries of a/ 
number entries of a section of a/ 
entries of a section of a/ ldlseek, 
of asectionofacommon/ _ldrseek, 
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jl, jn, yO, y1, yn: Bessel functions. 
jn, yO, yl, yn: Bessel functions. 
job control... 
job file for at 


-bessel(3M) 
-bessel(3M) 
-uustat(1C) 


join: relational database OpCrator.....ssesssesesensessaeee join(1) 
jrand48, srand48, seed48, Icong48~/. ..drand48(3C) 
JUMPS .....eceeecseesesssssnecesasasassesssensensenseases sigsetjmp(3C) 
kernel auto-configuration device table lumpconf(1M) 
ROY scsvsnstassosuscasrecastescesescersevatsesersaesttateietse makekey(1) 
keys to internal menu system functions. syskeymap(4) 
keyword lookup....csescsssssssssseeseeseees apropos(1) 
keywords to identify an operating. -locate(1) 
kill all active processes -killall(1M) 


kill child processes 
kill: send a signal to a process or.. 
kill: terminate a process......... 
killall: kill all active processes... 
kMBmem, kMWmem: MULITBUS memory. 
kmem: core memory . ..mem(7) 
kMWmem: MULITBUS memory.. -kmmem(7) 
KornShell, a standard/restricted command and /......ksh(1) 
ksh, rksh: KornShell, a 
13tol, ltol3: convert between 3-byt 
164a: convert between long integer... 
labelit: provide labels for. 
labels for filesystems 
language... 
language... 


m_kill mnie 


“killall( 1M) 
-kmmem(7) 


“labelit( 1M) 
.labelit(1M) 


language... 
language specific strings.. 
lastlogin, monacct, nulladm, prctmp,... 
Ickpwdf, ulckpwdf: get shadow/. 
lcong48: generate uniformly/.. 
ld: link editor for object. 
1d0: STREAMS tty line discipline 
ldaclose: close a common object file.. 
ldahread: read the archive header of... 
ldaopen: open a common object file .. 
ldclose, Idaclose: close a common.. 
ldexp, modf: manipulate parts o 
ldfen: common object file access. 
ldfhread: read the file header of a. 
ldgetname: retrieve symbol name for... 
ldlinit, Idlitem: manipulate line... 
ldlitem: manipulate line number.. 
ldlread, Idlinit, Idlitem: 
ldlseek, Idnlseek: seek to line.. 
ldnlseek: seek to line number. 
ldnrseek: seek to relocation entries.. 


acctsh( 1M) 
.getspent(3X) 
.-drand48(3C) 


.ldelose(3X) 
.ldahread(3X) 
-ldopen(3X) 
.Idclose(3X) 


ldlseek(3X) 
....ldrseek(3X) 
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section header of a/ ldshread, 
section of a common object/ Idsseek, 
header of a common object file 
object file for reading 

relocation entries of a section of/ 
indexednamed section header of a/ 
indexednamed section of a common/ 
symbol table entry of a common/ 
table entry of a common object file 
of a common object file 

truncate a file to a specified 

init.d: system 

lexical tasks 

lex: generate programs for simple 
lsearch, 

intro: introduction to functions and 
find ordering relation for an object 
introduction to Parallel Programming 
t_sync: synchronize transport 
t_alloc: allocate a 

t_free: free a 

shell (command interpreter) with C- 
quota: display disk usage and 
ulimit: get and set user 
implementation-specific constants 
returns the number of CPUs on- 

line: read one 

puts its arguments on message 

all but one active processor off 
reads file and gets longest 

establish an out-going terminal 

set terminal type, modes, speed, and 
1d0: STREAMS tty 

set terminal type, modes, speed, and 
man: display on- 

linenum: 

Adlinit, ldlitem: manipulate 
acommon/ ldlseek, ldn)seck: seek to 
nl: 

cut: cut out selected fields of each 

Ip: Systech parallel 

wp: SSM parallel 


lsearch, I find: 

col: filter reverse 

common object file 

readlink: read value of a symbolic 
link, unlink: 

ld: 

a.out: common assembler and 


cp, In, mv: copy, 
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ldnshread: read an indexednamed.. 
Idnsseek: seek to an indexednamed 
ldohseek: seek to the optional file 
Idopen, ]daopen: open a common. 


ldrseek, ldnrseek: seek to.. Idrseek(3X) 
ldshread, Idnshread: read an dshread(3X) 
ldsseek, ldnsseek: seek to an..... -ldsseek(3X) 
ldtbindex: compute the index of a .Idtbindex(3X) 
ldtbread: read an indexed symbol... ..ldtbread(3X) 
ldtbseek: seek to the symbol table. ldtbseek(3X) 
ONASUV sans ccssncssissorseaseizcssosesnessis .truncate(2SEQ) 


level transition files directory. 
lex: generate programs for simple 
lexical tasks.... 
lfind: linear search and update. 
libraries... 
see C and Lang Tools Binder 
.intro(3PPS) 


limits... 
ulimit(2) 
.limits(4) 


line cpus_online(3PPS) 
line »line(1) 
line message(1F) 


..offline_all(3SEQ) 
.readfile(1F) 


line discipline. 


Nine Aisi pline jsrcseccesessscassiscssisstaseacacriserecernnrpanmiienss 1d0(7) 
line discipline uugetty(1M) 
line man pages.. -man(1) 
line number entries in a common obje «linenum(4) 
line number entries of a common object/ .Idlread(3X) 
line number entries of a section o -ldlseek(3X) 


line of a file. 
line printer interface 
line printer interface 
line: read one line..... 
linear search and update 


Mime <f6OUS. .scsesceaiadssscsyaissascsesasssosecesonsssaccoateurssnesiecessasniitens’ col(1) 
Jinenum: line number entries in a « linenum(4) 
ibe sssauaucassienavescassea actnssneusacssucanan -readlink(2SEQ) 
link and unlink files and directories »link(1M) 
link editor for object files see C and Lang Tools Binder 
link editor output... a.out(4) 
link: link to a file. ink(2) 
Tink or move files.........cccsssscecssssosscsscesescecsersesenseesuscaceacoses cp(1) 
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link: 
symlink: make symbolic 
and directories 


initgroups: initialize group access 
nlist: get entries from name 
setgroups: set group access 
varargs: handle variable argument 
output of a varargs argument 

1s: 

ff: 

checklist: 
getitems: returns a 
t_listen: 

listing 

xargs: construct argument 
volcopy: make 

cp, 
ctime, 
apropos: 
operating system command 
setlocale: set programs 
end, etext, edata: last 
plock: 

m_lock, m_unlock: 

s_clock, s_unlock: initialize, 


fsck and ncheck 


ascftime, mktime, tzset/ 


lockf: record 

m_lock, m_unlock: lock, unlock 
s_unlock: initialize, lock, unlock 
diagnostic messages to form error 
errorlog: internal error 

gamma: 

newgrp: 

logging and event tracing 

logarithm, power, square root/ exp, 
about RCS files rlog: print 
/usr/adm/loginlog: 

sulog: 

logarithm, power, square/ exp, log, 
log, log10, pow, sqrt: exponential, 
strclean: STREAMS error 

strerr: STREAMS error 

log: interface to STREAMS error 
/usr/adm/loginlog: log of failed 
getlogin: get 

logname: get 

cuserid: get character 

logname: return 

passwd: change 

tfmenush: assign menu system as user 
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link, unlink: link and unlink files. 
lint: a C program checker......see C and Lang Tools Binder 
..initgroups(3SEQ) 


iE sscscccssscassicsensceegntestonnsicoscscsccssiteisesterséensasesteccansuseeseed nlist(3C) 
list.. .setgroups(2SEQ) 
i varargs(5) 
-Vprint{(3S) 


list of filesystems processed by... 
list of the currently marked menu items. 
listen for a connect request. 


checklist(4) 
.getitems(1F) 
act! —listen(3N) 


list: produce C source .........+0+ 

list(s) and execute command ..xargs(1) 
literal copy of filesystem....... olcopy(1M) 
In, mv: copy, link or MOVE filCS......sssssescessseessesesereneeseee cp(1) 
localtime, gmtime, asctime, cftime, .. ctime(3C) 
locate commands by keyword lookup. ..apropos(1) 
locate: use keywords to identify an....ssessseessseeesers locate(1) 
location. 


-setlocale(3C) 


locations in program. 
lock process, text, or data in memory. 
lock, unlock locks. 
lock, unlock locks. 
lockf: record locking on 
locking on files... 


.s_lock(3PPS) 
lock (3C) 
-lock{(38C) 


locks. .s_lock(3PPS) 
log.. .dmesg(1M) 
log file. ‘ 


log gamma function. 
log in to a new group... 
log: interface to STREAMS error... 
log, log10, pow, sqrt: exponential,.. 
log messages and other information. 
log of failed login attempts... 
log of substitute user events. 
log10, pow, sqrt: exponential, 
logarithm, power, square root/ 
logger cleanup program. 
logger daemon... 


‘strelean( 1M) 
.-Strerm(1M) 


logging and event tracing. ..log(7) 
login attempts .-loginlog(4) 
login name.. getlogin(3C) 
login name.. -logname(1) 
login name of the user. .cuserid(3S) 
login name of user...... .-logname(3X) 
login password and password attributes. ...passwd(1) 
login shell....... tfmenush(1M) 
login: sign on.. login(1) 
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setting up an environment at 
Ausr/adm/ 


setjmp, 

readfile, 

apropos: locate commands by keyword 
make a database for fast password 
relation for an object library 

the LP print service 

cancel; send/cancel requests to the 
Ipadmin: configure the 

administer filters used with the 
administer forms used with the 
information about the status of the 
Apshut, lpmove: start/stop the 
enable, disable: enable/disable 
accept, reject: allow or prevent 
interface 

service 

with the LP print service 

the LP print service 

processing module 

service and move/ _Ipsched, Ipshut, 
the LP print service and move/ 

print service and move/ lpsched, 
status of the LP print service 
supported by the menu system 
priorities 

srand48, seed48/ drand48, erand48, 


update 


stat, 

integers and long integers 13tol, 
u3b2, u3b5, vax: get processor type/ 
show the configuration of the 

sysi86: 

values: 

sgetl: access long integer data ina 
m4; 

mtio: UNIX 

tg: SCSI 1/2-inch 

xt: Xylogics 472 MULITBUS 

mt: 

rmail: send mail to users or read 
read mail 

mail, rmail: send 

enhancement request 

processing system 

groups of programs make: 
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login time. 
loginlog: log of failed login attempts. 
logname: get login name 
logname: return login name of user.. 
longjmp: non-local goto... 
longline: reads file and gets longest line 
lookup... 


logname(1) 
logname(3X) 
..setjmp(3C) 
readfile(1F) 
.-apropos(1) 
‘mkpwdbm(1M) 
see C and Lang Tools Binder 
Ip, cancel: send/cancel requests to.. 
LP print service.... 

LP print service 
LP print service 
LP print service. 
LP print service... 
LP print service and move requests.. 
LP printers... 


...-lpfilter(1M) 
Ipforms(1M) 
ues Ipstat(1) 
lpsched(1M) 
..-enable(1) 


LP réquiesta:.: -accept(1M) 
Ip: Systech parallel line printer......ssssesssssessessesereeseseeseee lp(7) 
Ipadmin: configure the LP print... lpadmin(1M) 
Ipfilter: administer filters used.. Ipfilter(1M) 


lpforms: administer forms used with 
lpmod: parallel printer canonical... 
Ipmove: start/stop the LP print.. 
Ipsched, Ipshut, Ipmove: start/stop 
Ipshut, Ipmove: start/stop the LP... 
Ipstat: print information about the. 
lptypes: table of printer types. 
Ipusers: set printing queve........ 
lrand48, nrand48, mrand48, jrand48 


Is: Hist contents of direCtOry....ssesssssssccssesssesseessscessessecssees 1s(1) 
lsearch, Ifind: linear search and.. -lsearch(3C) 
lseek: move read/write file pointer ..1seek(2) 
Istat, fstat: get file status........ .Stat(2) 
ltol3: convert between 3-byte.. .-13tol(3C) 
M4: MACYO PLOCeSSOF ...seceseeeee -.m4(1) 
machid: i386, ns32000, pdp11, u3b .«.machid(1) 
MACHINE .....ssssesseseeneseserere " showefg( 1M) 
machine specific functions -sysi86(2) 
machine-dependent values.. .values(5) 
machine-independent fashion.. «sputl(3X) 
MACTO PLOCCSSOF....ceseeeeree ..m4(1) 
magnetic tape interface -mtio(7) 


magnetic tape interface. 
magnetic tape interface. 
magnetic tape mennipoleting program... 
MAI]... sssesseeeseseinceerensnes 
mail, rmail: mad mail to users or... 
mail to users or read mail......... 
mailbug: submit a bug report or. 
mailx: interactive message 
maintain, update, and regenerate. 


wtg(7) 
xt(7) 
mt(1) 
-mail(1) 
-mail(1) 
-mail(1) 
= 
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programs intro: introduction to 
/ttyname_to_dev: convert between 
regenerate groups of programs 

man page databases 


databases makealiases, 
/free, realloc, calloc, mallopt, 
memory allocator 

mallopt, mallinfo: fast main memory/ 
malloc, free, realloc, calloc, 


makealiases, makewhatis: generate 
man: display on-line 

tsearch, tfind, tdelete, twalk: 
hsearch, hcreate, hdestroy: 
t_optmgmt: 

passmgmt: password files 
sigignore, sigpause: signal 
format disks or perform other defect 
file format isismgr: ISIS file 
mt: magnetic tape 

parameters of virtual-to-physical 
m_single, m_multi: 

umask: set file-creation mode 
umask: set and get file creation 
regex: 

regular expression compile and 
math: 


endpoint 


comment section 


read the archive header of a 

groups: show group 

memset: memory operationsnemory: 
memory operationaemory: memccpy, 
operationemory: memccpy, memchr, 
memory: memccpy, memchr, mememp, 
kMBmem, kMWmem: MULITBUS 
mem, kmem: core 

lock process, text, or data in 

create security table in shared 
malloc, free, realloc, calloc: main 
calloc, mallopt, mallinfo: fast main 
shmalloc, shrealloc, shfree: shared 
valloc: aligned 

shmctl: shared 

consmem, 8m, ss: console 

dump: standalone 

spawn new process in a virtual 
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maintenance commands and application..........000+ intro(1) 
major/minor numbers/tty names.........dev_to_ttyname(3C) 
make: maintain, update, and. 
makealiases, makewhatis: generate . 
makedev: make system special files 
makekey: generate encryption key. 
makewhatis: generate man page.... 
mallinfo: fast main memory allocator. 
malloc, free, realloc, calloc: main 
malloc, free, realloc, calloc, 
mallopt, mallinfo: fast main memory 
man: display on-line man pages. 
man page databases... 
man pages.. 
manage binary search trees 
manage hash search tables... 
manage options for a transport 
management .. 
management.. 
management functions...... 

manager, updates text files in ISIS 
manipulating program.. 
mapping devices..... 
mark single-process code section. 
MASE casscscecsassasctosisacicascetetecnateaty 


makealiases(1M) 
-malloc(3X) 
.malloc(3C) 
-malloc(3X) 
-malloc(3X) 
...man(1) 
makealiases(1M) 


t optmgmt(3N) 


. passmgmt(1M) 


match patterns against a string. 
match routines .....sesesesesereereeceses 
math functions and constants......... 

math: math functions and constants.. 
matherr: error-handling function 
mbad: MULITBUS adapter......... 
mcs: manipulate the object file. 
mem, kmem: core memory..... 
member of an archive file 


“matherr(3M) 
..mbad(7) 


MeMbETSHiIpS «...s.sseeeeeseeeeee ...groups(1) 
memccpy, memchr, memcmp, memcpy, ..memory(3C) 
memchr, memcmp, memcpy, memset:. -memory(3C) 
memcmp, memcpy, memset: memory, .-memory(3C) 
memepy, memset: memory operations.. ..memory(3C) 

-kmmem(7) 


.«mem(7) 


.-plock(2) 
memory... ...tasktbl(1M) 
memory allocator.. -malloc(3C) 
memory allocator. -malloc(3X) 
memory allocator. shmalloc(3PPS) 
memory allocator. valloc(3SEQ) 
memory control operations.. .-- shmcetl(2) 
memory drivers. consmem(7) 


memory dump.. 
memory efficient way 
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queue, semaphore set, or shared 
memcpy, memset: memory operations 
memchr, memcmp, memepy, memset: 
shmop, shmat, shmdt: shared 

vmtune: tune system-wide virtual- 
shmget: get shared 

vm_ct]: examine and change virtual 
memccpy, memchr, memcmp, memcpy, 
addcmdopt: add a command option to a 
add a form/SELECT window option to a 
addmenuopt: add a menu option to a 
sysadm: 

a list of the currently marked 


menumsg: route user message to 
rmvopt: remove a 

addmenuopt: add a 

menu: 

of printer types supported by the 
tfmenush: assign 

syskeymap: identify keys to internal 
message queue 

for generating/modifying ASSIST 
merge: three-way file 

sort: sort and/or 

acctmerg: 

resmerge: 


subsequent lines of one file _ paste: 


t_error: produce error 

tfnotify: send completion 

msgctl: 

message: puts its arguments on 
getmsg: get next 

putmsg: send a 

msgop: 

mailx: interactive 

message line 

menumsg: route user message to menu 
msgget: get 
iperm: remove a 
errormsg: error 
menumsg: route user 

motd: 

mesg: permit or deny 

sys_errlist, sys_nerr: system error 
strace: print STREAMS trace 

rlog: print log 

dmesg: collect system diagnostic 

F parallel 
identification 


shared memory ID 
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memory ID... 
memory: memecpy, mem 
memory operations.. 
memory operations... 
memory parameters 


memory segment identifier.. .... shimget(2) 
memory tuning parameters. -vmn_ctl(2SEQ) 
memset: memory operations ..memory(3C) 
menu.. .addcmdopt(1M) 
menu... addformopt(1M) 
menu... ..addmenuopt(1M) 
menu interface to do system administration....... sysadm(1) 
menu items.. getitems(1F) 
menu: menu processor ..menu(1M) 
menu message queue... menumsg({1M) 
menu option........ rmvopt(1M) 
menu option to a menu .addmenuopt(1M) 
menu processor menu(1M) 
menu system. lptypes(4) 
menu system as user login shell. tfmenush(1M) 
menu system functions. «syskeymap(4) 


menumsg: route user message to menu.. 
menus or command forms. 
merge 
merge files. 
merge or add total accounting files 
merge RCS revisions ........ssssseeeeere ae 
merge same lines of several files or. 
merge: three-way file merge.... 
mesg: permit or deny messages... 
message . 
message. 
message control operations 
message line 
message off a stream. 
message on a stream... 
message operations 
message processing system... 
message: puts its arguments on.. 
message queue... 
message queve.... 
message queue, semaphore set, or... 
message text file.....ssecsssseeessrsseees oy 

message to menu message queue enumsg(1M) 
message-of-the-day file motd(4) 
messages... 


..resmerge(1) 
..paste(1) 
..merge(1) 
....mesg{ 1) 
.t_error(3N) 
tfnotify(1M) 
...msgetl(2) 
.-message(1F) 


messages 
messages .strace(1M) 
messages and other information about RCS files.......rlog(1) 
messages to form error log. ....dmesg( 1M) 
m_fork: execute a subprogram in m_fork(3PPS) 
m_get_myid: return ProcesS......sseevesere m_get_myid(3PPS) 
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number of child processes 

getusclk, usclk_init: get/init 

usclk: 32-bit 

aging, PFF, swapping, or processor 
clone: open any 

/convert between major/ 

/acctwtmp: overview of accounting and 
intro: introduction to 


special or ordinary file 
password lookup 


/gmtime, asctime, cftime, ascftime, 


processs address space 


section m_single, 


configuration file 

chmod: change 

umask: set file-creation 

chmod: change 

cpset; copy file and set 

getty: set terminal type, 
uugetty: set terminal type, 
frexp, ldexp, 

utime: set file access and 
touch: update access and 
astgen: program for generating/ 
printer canonical processing 
SSM: System Services 

Interface cooperating STREAMS 
read/write interface STREAMS 
mod_config: format of a 
/ckpacct, dodisk, lastlogin, 
helplog: 


monitor: 
atime 


mount: 
mount, umount: 


setmnt: establish 
filesystems 


36 


m_get_numprocs: return 
microsecond clock..... 
microsecond counter. 
migration disabled... 
minor device on a STREAMS driver.. 


m_get_numprocs(3PPS) 
getusclk(3SEQ) 

aeeaee uscelk(7) 
-noage(1M) 
clone(7) 
.dev_to_ttyname(3C) 
-acet(1M) 


mkdir: make a directory. 
mkdir: make directories. 
mkfifo: make a FIFO special file. 
mkfs: construct a filesystem..... 
m_kill_procs: kill child processes 
mknod: build special file.............08 
mknod: make a directory, or 8......0 
mkpwdbm: make a database for fast.. 
mktemp: make a unique filename..... 
mktime, tzset: convert date and time/.. 
mkvtoc: populate VTOC on disks......... 
m_lock, m_unlock: lock, unlock locks. 
mmap: map an open file into the. 
m_multi: mark single-process code. 
m_next: increment global counter.. 
mnttab: mounted filesystem table .. 
mod_config: format of a module... 


mkpwdbm(1M) 
-mktemp(3C) 
..ctime(3C) 
.-mkvtoc(1M) 
.-m_lock(8PPS) 
.mmap(2SEQ) 
.-m_single(3PPS) 
-m_next(3PPS) 

sous mnttab(4) 
.-mod. cone 


mode mask 
mode of file.. 
mode, user, and group IDs. 
modes, speed, and line discipline. 
modes, speed, and line discipline 
modf: manipulate parts of floating-point/.. 
modification times... 
modification times of a file. 
modifying ASSIST menus or command/,. 
module... 


cpset(1) 
.getty(1M) 
-uugetty(1M) 
frexp(3C) 
utime(2) 
.touch(1) 


“mod |_config(4) 
acctsh(1M) 
helplog(4) 
monitor({1M) 
-monitor(3C) 


module configuration file 
monacct, nulladm, pretmp, prdaily/.. 
monitor help actions 
monitor: monitor system activity .... 
monitor: prepare execution profile... 
monitor system activity csc 
more: view a file one full screen at.. 
motd: message-of-the-day file 
mount a filesystem... 
mount and unmount filesystems... 
mount: mount a filesystem. 
MONE table.....ecssseeceeeeeeseses 
mount, umount: mount and unmount. 


ad “setmnt(1M) 
...mount(1M) 
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mountall, umountall: 

multiple filesystems 

muttab: 

mvdir: 

cp, In, mv: copy, link or 

lseek: 

start/stop the LP print service and 
and resume child process execution 
ptrace, 

drand48, erand48, lrand48, nrand48, 
child process/ m_park_procs, 
processes 


single-process code section 


program 
st: Systech 


mbad: 

xt: Xylogics 472 

kMBmem, kMWmem: 

mountall, umountall: mount, unmount 
poll: STREAMS input/output 

Systech MTI-800/1600/1650 terminal 
xs: Xylogics 781 terminal 

tmp_ctl: 

re2: run commands performed for 
m_lock, 

address space 

cp, In, 


devnm: device 

getenv: return value for environment 
getgeombyname: get disk geometry by 
getlogin: get login 

logname: get login 

pwd: working directory 
tmpnam, tempnam: create a 
ldgetname: retrieve symbol 
getpw: get 

nlist: get entries from 
rename: change the 
ttyname, isatty: find 

uname: get 

uname: print 

tty: get the 

cuserid: get character login 
logname: return login 
Adnshread: read an indexed 
Adnsseek: seek to an indexed 


table/ 
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mount, unmount multiple filesystems........... mountall(1M) 
mountall, umountall: mount, unmount... -mountall(1M) 
mounted filesystem table ...-mnttab(4) 
move a directory . 

move files... 

move read/write file pointer 

MOVE TEQUESES.......csesereereeeees: 


m_park_procs, m_rele_procs: susp/....m_park_procs(3PPS) 
mptrace: process trace facility ptrace(2) 
mrand48, jrand48, srand48, seed48/.. drand48(3C) 
m_rele_procs: suspend and resume....m_park_procs(3PPS) 
m_set_procs: set number of child... m_set_procs(3PPS) 
msgct]: message contro] operations. «-msgctl(2) 
msgget: get message queue.... -msgget(2) 
msgop: message operations .. msgop(2) 
m_single, m_multi: mark -m_single(3PPS) 
m_syne: check in at barrier m_sync(3PPS) 
mt: magnetic tape manipulatin; 5 

MTI-800/1600/1650 terminal multiplexor driver 
mtio: UNIX magnetic tape interface 


MULITBUS adaptel....csesseceseeseesees 

MULITBUS magnetic tape interface . 

MULITBUS memory ... kmmem(7) 
multiple filesystems.. ountall(1M) 
multiplexing....... 


multiplexor driver.. 
multiplexor driver.. 


multi-processor control sseseetmp_ctl(2SEQ) 
Multi-user ENVITONMENLE.....ccseceeesecserereesseerrenerosnee re2(1M) 
m_unlock: lock, unlock locks.. -m_lock(3PPS) 
munmap: unmap part of the processs........ munmap(2SEQ) 


mv: copy, link or move files. 
mvdir: move a directory... 
name... 


ame(3SEQ) 
..getlogin(3C) 
.-.logname(1) 
name... 
name for a temporary file 
name for common object file symbol 
name from IUD. 
name list...... 
name of a file... 
name of a terminal 
name of current operating system 
name of current SYSteM..........se0e0e0 
name of the terminal. 
name of the user.. 
name of user.... 


rename(2) 
yname(3C) 
<uname(2) 
.uname(1) 
.tty(1) 
..cuserid(3S) 


named section header of a common object/.....\dshread(3X) 
named section of a common object file......... seul dsseek(3X) 
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between major/minor numbers and tty 
id: print user and group IDs and 

term: conventional 

isnanf: test for floating-point 
"processing language 

and indirect blocks 

of filesystems processed by fsck and 
i-numbers 


news: print 


getmsg: get 


object file 

command with priority aging, PFF/ 
hangups and quits 

setjmp, longjmp: 

sigsetjmp, siglongjmp: 

with priority aging, PFF/ noage, 
priority aging, PFF/ — noage, nopff, 
test for floating-point NaN 

seed48/ drand48, erand48, lrand48, 
deroff: remove 
machid: i386, 
null: the 


vax: get processor/ 


/ckpacct, dodisk, lastlogin, monacct, 
obtain the prime factors of a 
getfrm: returns the current frame 
test for floating-point NaN (Not-A- 
convert string to double-precision 
linenum: line 

Adlinit, ldlitem: manipulate line 
ldlseek, ldniseek: seek to line 

rand, srand: simple random- 
nblocks: calculate 

m_get_numprocs: return 
m_set_procs: set 

cpus_online: returns the 

df: report 

fevt, gcvt: convert floating-point 

nl: line 

uniformly distributed pseudorandom 
manipulate parts of floating-point 
install random inode generation 

to system calls and error 
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names. 
names. 
names for terminals... 
NaN (Not-A-Number)... 
nawk: pattern scanning and.. 
nblocks: calculate number of blocks 
ncheck.. 
ncheck: generate pathnames from 
networking support files............00. 
newform: change the format of a text. 
newfs: construct a new file system... 
newgrp: log in to a new group 
NEWS ItOMB......sceeceseneeeees 
news: print news items. 
next message off a stream.. 
nice: change priority of a process. 
nice: run a command at Jow priority... 
nl: line numbering filter 
nlist: get entries from name list 
nm: print name list Of........0+0+ see C and Lang Tools Binder 
noage, nopff, noswap, onproc: run a .-noage(1M) 
nohup: run a command immune to.. ..nohup(1) 
non-local goto...... 
non-local jumps.. 
nopff, noswap, onproc: run a command... 
noswap, onproc: run a command with 
(Not-A-Numb01r)..ccsecesssrseeereseeeeseses 
nrand48, mrand48, jrand48, srand48, 
nroff, tbl, and eqn constructs........ 
ns32000, pdp11, u3b, u3b2, u3b5, 
NUI] file... esesseeseenes 
null: the null file .... 
nulladm, pretmp, prdaily, prtacct,/. 


dev_to_ttyname(3C) 


..newform(1) 
newfs(1M) 
-newgrp(1M) 
.news(1) 
.news(1) 
apg 


drand48(3C) 
...derof{1) 
-machid(1) 


number.. 
number... 
Number) .isnan(3C) 
number... -strtod(3C) 


inenum(4) 
..ldlread(3X) 
ldlseek(3X) 


number entries in a common object file. 
number entries of a common object/.... 
number entries of a section of a/.. 
NUMbEF GENCLAatOL....sssecssseressesesseesssseeensesesneanentersesees rand(3C) 
number of blocks and indirect blocks. nblocks(3SEQ) 
number of child processes .. ..m_get_numprocs(3PPS) 
number of child processes... ..m_set_procs(3PPS) 
number of CPUs on-line.. cpus_( sami 
number of free disk blocks and inodes. 
number to string.... 
numbering filter 
numbers... 
numbers 


need frexp(3C) 
.fsirand(1M) 
intro(2) 


DYNIX]/ptx Reference Manual 


Permuted Index 


ncheck: generate pathnames from i- 
/convert between major/minor 

cprs: compress an 

strstr: find first 

od: 


offline: bring processors online and 
online, 

processor off line 

online, offline: bring processors 
online and offline 
noage, nopff, noswap, 
ldopen, Idaopen: 
fopen, freopen, fdopen: 
clone: 

dup: duplicate an 
dup2: duplicate an 
mmap: map an 

open: 


aging, PFF,/ 


rewinddir, closedir/ directory: 

a standalone program or bring up the 
run commands performed to stop the 
savecore: save a core dump of the 
uname: get name of current 

locate: use keywords to identify an 
assist: assistance using 

starter: information about the 

help: 

glossary: definitions of common 

join: relational database 

curses: terminal screen handling and 
rmvopt: remove a menu 

getopt: get 

addcmdopt: add a command 
addformopt: add a form/SELECT window 
addmenuopt: add a menu 
ldohseek: seek to the 
fentl: file control 

getopt: parse command 
getopts, getoptcvt: parse command 
atty: set the 

t_optmgmt: manage 

make a directory, or a special or 
architecture information 

common assembler and link editor 
echo: put string on virtual 

fread, fwrite: binary input/ 

fprintf, sprintf: print formatted 
poll: STREAMS input/ 

Afprintf, vsprintf: print formatted 
stdio: standard buffered input/ 


object file 
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numbers... -ncheck(1M) 


dev_to_ttyname(3C) 


octal dump..... 
od; octal dump. 


offline: bring processors online and offline......... 
offline_all: take all but one active. .-offline. pcre 
online and offline 
online, offline: bring processors. 
onproc: run a command with priority 
open a common object file for reading. 
OPEN B SEFCAM.... cc csesseeressceseerensesereeeneease 
open any minor device on a STREAMS driver. 
open file descriptor.. 
open file descriptor. 
open file into the processs address space. 
open for reading or writing. 
open: open for reading or writing. 
opendir, readdir, telldir, seekdir,.. 
operating system... 
operating system. 
operating system 
operating system. 
operating system command. 
operating system commands... 
operating system for beginning users... 
operating system Help Facility 
operating system terms and symbols.. 


“rc0( 1M) 
..-Bavecore(1M) 
-uname(2) 


».glossary(1) 


OPEL ALON si sccaaterssssivasacassasevsucststoncnssnssuasienssescctvinaraaectaannaes join(1) 
optimization package. curses(3X) 
option... rmvopt(1M) 
option letter from argument vector.. -» getopt(3C) 
option to a menu.. .addemdopt(1M) 
option to a menu... ... addformopt(1M) 
option to a menu ..addmenuopt(1M) 
optional file header of a common.. ..ldohseek(3X) 


faeaa fentl(5) 
getopt(1) 


options.... 
options. 


options getopts(1) 
options fora terminal scsccisccssccnancssansnmsanconcenans stty(1) 
options for a transport endpoint .t_optmgmt(3N) 
ordinary file... -mknod(2) 
ott: files that hold object. ; 
output... 

output. 

output... 


output. 
output multiplexing 
output of a varargs argument list... 
output package 


““vprintf{3S) 
stdio(3S) 
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setpgrp: run command in its 
chown: change 

chown, chgrp: change 

expand files 

makewhatis: generate man 
getpagesize: get system 

4014: 

m_fork: execute a subprogram in 
Ip: Systech 

wp: SSM 

lpmod: 

intro: introduction to 

and change virtual memory tuning 
tune system-wide virtual-memory 
pmap: display or alter 

get process, process group, and 
getopt: 

getopts, getoptcvt: 

cmpt: compatibility 

vtoe: VTOC 

frexp, ldexp, modf: manipulate 


with information from /etc/ 
password attributes 


getpass: read a 

crypt: 

passwd: change login 

passwd: change login password and 
pwdhd: daemon to oversee 

pwfix: remove incorrectly formatted 
passwd: 

shadow: restricted 

setpwent, endpwent, fgetpwent: get 
Ickpwdf, ulckpwdf: get shadow 
putpwent: write 

putspent: write shadow 

converts from a two to a one 
passmgmt: 

mkpwdbm: make a database for fast 
pwek, grpck: 

files or subsequent lines of one/ 

bp: binary 


configurable pathname variables 
criteria for filename 

getcwd: get 

fpathconf: get configurable 
dirname: deliver portions of 
ncheck: generate 

sweepon, sweepoff: enable/disable 
grep: search a file for a 
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own process group... 
owner and group of a file. 
OWNEY OF ZTOUP..ersseeeeeeeees 


pack, peat, unpack: compress and... ..pack(1) 
page databases. makealiases(1M) 
page size .getpagesize(2SEQ) 
paginator for the Tektronix 4014 terminal.............. 
PArAllel.......cccccsscsssscsssscsesssercecereseseecssacsesnrorensenes 

parallel line printer interface... 


parallel line printer interface... 
parallel printer canonical processing module. 
Parallel] Programming Library 
parameters.. 
parameters.. ..vmtune(1M) 
parameters of virtual-to-physical mapping/........pmap(1M) 
parent process IDs. w+. getpid(2) 
parse command options.. .getopt(1) 
parse command options... 
partitioning driver... 
partitioning driver... 


parts of floating-point numbers frexp(3C) 
passmgmt: password files management....... passmgmt(1M) 
passwd ..pweonv(1M) 


passwd: change login password an: ..passwd(1) 
passwd: password file . ..passwd(4) 
PABSWOTK ...esessovereeeeres getpass(3C) 


password and file encryption functions. ..crypt(3X) 
password and password attributes. 
password attributes..... 
password database creation. 
password entries 


password file...... 


password file.......... ..shadow(4) 
password file entry. getpwent(3C) 
password file entry .getspent(3X) 
password file entry ...putpwent(3C) 
password file entry... ....putspent(3X) 
password file scheme .pwunconv(1M) 
password files management... .passmgmt(1M) 
password lookup.......+» mkpwdbm(1M) 
password/group file checkers pwek(1M) 


paste(1) 
««-bp(1M) 


paste: merge same lines of several. 
patcher. 


pathalias: alias file for FACE......sssesesssscssessessontssneanen alias(4) 
pathconf, fpathconf: get..... pathcon{{(2) 
pathconv: search Interpreter. pathconv(1F) 
pathname of current working directory... getcwd(3C) 
pathname variables. pathconf(2) 
pathname’....e..csreseee -basename(1) 
pathnames from i-numbers.. ncheck(1M) 
patrol seeks on DCC disks. «sweepon(1M) 
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awk: 

nawk: 

egrep: search a file for a 
regex: match 


pack, 
popen, 


machid: i386, ns32000, 

sigpending: examine 

check the uucp directories and 
acct: 

acctems: command summary from 
sys_nerr: system error messages 
run a command with priority aging, 


virtual address space pmap: map 
or alter parameters of virtual-to- 


sp: STREAMS 

tee: 

popen, pclose: initiate 
in memory 


virtual-to-physical mapping devices 
processs virtual address space 
/fpsetsticky: IEEE floating- 

isnand, isnanf: test for floating- 
ecvt, fevt, gcvt: convert floating- 
modf: manipulate parts of floating- 
Iseek: move read/write file 

rewind, ftell: reposition a file 
multiplexing 

@ process 

banner: make 

power, square root/ exp, log, log10, 
pow, sqrt: exponential, logarithm, 


/dodisk, lastlogin, monacct, nulladm, 
Nastlogin, monacct, nulladm, pretmp, 
be: arbitrary- 

atof: convert string to double- 
.environ, 

monitor: 

cpp: the C language 

factor: obtain the 

gps: graphical 

types: 

prs: 

date: 

cal: 
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pattern scanning and processing language ............ awk(1) 
pattern scanning and processing language.. .nawk(1) 
pattern using full regulary... .egrep(1) 
patterns against a string... »regex(1F) 


pause: suspend process until] signal. 
peat, unpack: compress and expand files... a 
pclose: initiate pipe to/from a process. Fi 

pdbx, dbx: parallel/.........0e+0« see C and Lang Tools Binder 
pdp11, u3b, u3b2, u3b5, vax: get processor/. .machid(1) 


pending signals... ..8igpending(2) 
permissions file... uucheck(1M) 
per-process accounting file forma’ acct(4) 
per-process accounting records acctems(1M) 


perror, errno, sys_errlist,....... 
PFF, swapping, or processor/. 
pg: file perusal filter for CRTs... 
physical addresses into processs.. 
physical mapping deviceS.........0 
pipe: create an interprocess channel... 
pipe device... 
pipe fitting... 
pipe to/from a process... 
plock: lock process, text, or data... 
plot: graphics interface..........-.++ 
plot: graphics interface subroutines. 
pmap: display or alter parameters of. 
pmap: map physical addresses into 
point environment control..... 
point NaN (Not-A-Number) 
point number to string 
point numbers 


plock(2) 
plot(4) 
-plot(3X) 


pointer in a stream. 
poll: STREAMS input/output......... 
popen, pclose: initiate pipe to/from. 
POStCTS ...scesrescerssnrssressssascacecensseronseon 
pow, sqrt: exponential, logarithm, 
power, square root functions.. 
PT: Print fICS.......ersenceeeeeeseeseee 
pretmp, prdaily, prtacct, shutacct,. 
prdaily, prtacct, shutacct, startup, 
precision arithmetic language.. 
precision NUMDET........s000 


.strtod(3C) 


.pref, .variables: FACE files.. ...env(4) 
prepare execution profile -monitor(3C) 
preprocessor see C and Lang Tools Binder 
prime factors of a number factor(1) 
primitive string, format of graphical files. -gps(4) 
primitive system data types... .types(5) 
print an SCCS file.......... -prs(1) 


print and set the date.. 
print calendar... 
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sum: 

sact: 

cat: concatenate and 

pr: 

printf, fprintf, sprintf: 
vprintf, vfprintf, vsprintf: 


of the LP print service Ipstat: 
information about RCS files rlog: 
object file mm: 
uname: 

news: 

infocmp: compare or 

acctcom: search and 

of object files size: 


send/cancel requests to the LP 
lpadmin: configure the LP 
administer filters used with the LP 
administer forms used with the LP 
about the status of the LP 

Apshut, lpmove: start/stop the LP 
strace: 


Ipmod: parallel 

Ip: Systech parallel line 

wp: SSM parallel] line 

Iptypes: table of 

enable, disable: enable/disable LP 
formatted output 

lpusers: set. 

lpusers: set printing queue 

nice: run a command at low 
/noswap, onproc: run a command with 
nice: change 

brk, sbrk: change 

process attributes 

codestroy: communicate to a 

exit, _exit: terminate 

fork: create a new 

inittab: script for the init 

kill: terminate a 

nice: change priority of a 

pclose: initiate pipe to/from a 
wait: await completion of 

acct: enable or disable 

acctprel, acctpre2: 

acct: per- 

acctcom: search and print 
acctems: command summary from per- 
alarm: set a 

times: get 
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sum(1) 
.sact(1) 


print checksum and block count of a file. 
print current SCCS file editing activity . 
print files.. 
print files. 
print formatted output. 
print formatted output of a varargs/.. vprint{(3S) 
print information about the status.... -lpstat(1) 
print log messages and Othe?.......ssssssseresesossersessssereeters rlog(1) 
print name list of... see C and ee Tools Binder 
print name of current system 
print news items... 
print out terminfo Seis eg -in oemp(1M) 
print process accounting files.. ....acctcom(1) 
print section SiZ@8.........ss00 see C and Lang Tools Binder 
print service 
print service. 
print service 
print service. 


.lpfilter(1M) 
.lpforms(1M) 


print service... ....|pstat(1) 
print service and move requests.. .lpsched(1M) 
print STREAMS trace messages strace(1M) 
print the VTOC of a block device.. .._prtvtoc(1M) 
print the VTOC of a standalone disk device..........privtoc(8) 


wid(1M) 
Ipmod(7) 
«1 p(7) 
.wp(7) 
..lptypes(4) 
enable(1) 
.. print (3S) 
.. lpusers(1M) 
..|pusers(1M) 


print user and group IDs and namez...... 
printer canonical processing module. 
printer interface... 
printer interface... 
printer types supported by the menu system.. 
PTINCCTS....cccccscsccrsccscscneeresssers: 
printf, fprintf, sprintf. rint... 
printing queue priorities. 
priorities... 


PTIOTIEY......-ecccococecssecssscsnsseccorssusesseessecnosessenssessrasensacorersons nice(1) 
priority aging, PFF, swapping, or/ -noage(1M) 
priority of a process......... »nice(2) 
private data segment size... .brk(3PPS) 
proc_ctl: control over various. proc_ctl(2SEQ) 
process... -coproc(1F) 


process. se@Xit(2) 
process 
process. 


process... 


process.... 
process accounting. 
process accounting... 


process accounting file forma a+ 800t(4) 


process accounting files...... acctcom(1) 
process accounting records. acctems(1M) 
process alarm clock........... alarm(2) 


process and child process times. .times(2) 
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proc_ctl: control over various 
m_single, m_multi: mark single- 
ipes: report inter- 

init, telinit: 

timex: time a command; report 
suspend and resume child 
setpgrp: run command in its own 
/getpgrp, getppid: get process, 
setpgrp: set 

setsid: create session and set 
tegetpgrp: get foreground 
tesetpgrp: set foreground 
m_get_myid: return 

process, process group, and parent 
vfork: spawn new 

kill: send a signal to a 

getpid, getpgrp, getppid: get 

ps: report 

plock: lock 

times: get process and child 
tmp_affinity: bind a 

wait, waitpid: wait for a child 
ptrace, mptrace: 

pause: suspend 

vsig: synchronize a co- 

checklist; list of filesystems 

a signal to a process or a group of 
killall: kill all active 

return number of child 
m_kill_procs: kill child 
m_set_procs: set number of child 
fuser: identify 

m4: macro 

menu: menu 

tmp_affinity: bind a process to a 
tmp_ctl: multi- 

priority aging, PFF, swapping, or 
offline_all: take all but one active 
pdp11, u3b, u3b2, u3b5, vax: get 
online, offline: bring 

mmap: map an open file into the 
munmap: unmap part of the 
pmap: map physical addresses into 


monitor: prepare execution 
profil: execution time 

prof: display 

at login time 

prof: 
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..proc_ctl(2SEQ) 
-m, mie 


process attributes... 
process code section 
process communication facilities status.. 
process control initialization... 
process data and system activity... 
process execution. 
process group. 
process group, and parent process IDs 
process group ID 
process group ID... 
process group ID.. 
process group ID... 
process identification. 
process IDs 
process in a virtual memory efficient way. 
process or a group of processes, 
process, process group, and parent/. 
PTOCEES StAtUS.....scrrserceseeeessereneres: 
process, text, or data in memory. 
process times.... 
process to a processor. 
process to stop or terminate. 
process trace facility. 
process until signal 
process with the controlling FMLI object 
processed by fsck and ncheck.. 
processes..... 
processes.. 
processes 
processes. 
processes... 
processes using a file or file structure.. 
processor .. 
processor... 
processor... 
processor control.. 
processor migration disabled.. 
processor Off line... 
processor type truth value 
processors online and offline 
processs address space.. 
processs address space... 
processs virtual address space. 
product: installed products file. 
prof: display profile data...... 
prof: profile within a function.. 
profil: execution time profile ... 
profile... 
profile... 
profile data . 
profile: setting up an environment 
profile within a function. 


“‘tmp_affinity(2SEQ) 
esate wait(2) 
..ptrace(2) 
... pause(2) 
.-V8ig( 1F) 
.checklist(4) 
-«kill(2) 
.Killall(1M) 
m_get_numprocs(3PPS) 
m_kill_procs(3PPS) 
.m_set_procs(3PPS) 


tmp_affinity(2SEQ) 
.tmp_ctl(2SEQ) 
..noage(1M) 
ne_all(3SEQ) 
...machid(1) 
-online(1M) 
...mmap(2SEQ) 
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end, etext, edata: last locations in 
mt: magnetic tape manipulating 
prompt: prompt 

sdiff: side-by-side difference 
STREAMS error logger cleanup 

units: conversion 

for the uucp file transport 

assert: verify 

ASSIST menus or command/ astgen: 
uucico: file transport 

installboot: installs a boot 

boot: run a standalone 

a standard/restricted command/ 

the standard/restricted command 
intro: introduction to Parallel 
maintenance commands and application 
update, and regenerate groups of 
lex: generate 

setlocale: set 

prompt: 


t_getinfo: get 
proto: 


/monacct, nulladm, pretmp, prdaily, 
device 
standalone disk device 


streampty: STREAMS 

getpseudotty: get 

cn: 

generate uniformly distributed 
time, 

facility 

uuto, uupick: 

ungete: 

puts, fputs: 

pute, putchar, fpute, putw: 
getdents: read directory entries and 
echo: 

character or word on a stream 

or word on a stream pute, 
environment 


stream 

message: 

entry 

getut: getutent, getutid, getutline, 
pute, putchar, fpute, 

checkers 


program .-strclean(1M) 
PTOQTAM oarccsascacsnesnscssessusovscsssocersessenssnsraesaseresavenseensevens units(1) 
program.. ..uusched(1M) 
program assertion ..assert(3X) 
program for generating/modifying ....astgen(1) 
program for the uucp system.. -uucico(1M) 
program on a disk -installboot(1M) 


program or bring up the operating system. 
programming language.. 
programming language. 
Programming Library... 
programs... 
programs.... 
programs for simple lexical tasks... 
programs location 
prompt program....... 


prompt: prompt program... prompt(1M) 
proto: prototype job file for at.. proto(4) 
protocol-specific service information .t_getinfo(3N) 
prototype job file for at... proto(4) 
prs: print an SCCS file.... .prs(1) 


prtacct, shutacct, startup/... «acctsh(1M) 
prtvtoc: print the VTOC of a block. 


prtvtoc: print the VTOC of a.. 


PS! TEPOTt PFOCeSS StALUS....cececsserereeseeserseaesnsnesnseerssnesneseees ps(1) 
pseudo terminal Ariver.......ssscessssesssseeseenenseeene streampty(7) 
pseudo terminals..... getpseudotty(3SEQ) 
pseudoconsole river ....ccsessessssessssesessesssnencensascnsenenseasnnes cn(7) 
pseudorandom numbers. ..drand48(3C) 
ptime: time a command... +etime(1) 
ptrace, mptrace: process trace. 


-ptrace(2) 
public UNIX-to-UNIX system file copy.. 6 
push character back into input stream 
put a string on @ Stream... 
put character or word on a stream. 
put ina file system independent/. 
put string on virtual output... 
pute, putchar, fputc, putw: put 


..echo(1F) 
putc(3S) 


putchar, fputc, putw: put character.. putc(3S) 
putenv: change or add value to...... .putenv(3C) 
putmsg: send a message on a stream... .». putmsg(2) 
putpwent: write password file entry...... putpwent(3C) 


... puts(3S) 
message(1F) 
..putspent(3X) 


puts, fputs: put a string on a.......... 
puts its arguments on message line .. 
putspent: write shadow password file... 
pututline, setutent, endutent/..... 
putw: put character or word on a stream 
pwek, grpck: password/group file. 
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/etc/shadow with information from/ 


database creation 
password entries 
one password file scheme 


tput: initialize a terminal or 

route user message to menu message 
msgget: get message 

Ipusers: set printing 

iperm: remove a message 
quotacheck: filesystem 


consistency checker 


quotaon, 

quotas on and off 

edquota: edit user 

quotact]: manipulate disk 
repquota: summarize 

quotaon, quotaoff: turn filesystem 
generator 

fsirand: install 

rand, srand: simple 

fsplit: split [77, 


ratfor: 

scripts 

the operating system 
multi-user environment 


resintro; introduction to 

resfile: format of 

res: change 

secstorcs: build 

messages and other information about 
ci: check in 

co: check out 

resdiff: compare 

resmerge: merge 


commands 


getpass: 

of a common object file Idtbread: 
header of a/ ldshread, ldnshread: 
structure read_constab: 
file system independent/ getdents: 
read: 

mail, rmail: send mail to users or 
line: 
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pwconv: installs and updates... .pweonv(1M) 


pwd: working directory name......sssssccsesersrserosreeesesseee pwd(1) 
pwdhd: daemon to oversee password.. pwdhd(1M) 
pwfix: remove incorrectly formatted......ssssssssseeee pwfix(1M) 
pwunconv: converts from a two to a. pwunconv(1M) 
qsort: quicker SOrt.....s.0e+ qsort(3C) 
query terminfo database ....tput(1) 
.-menumsg( 1M) 

msgget(2) 

queue priorities.. .. pusers( 1M) 
queue, semaphore set, or shared memory ID..........iperm(1) 
quota consistency checker.. ..quotacheck(1M) 
quota: display disk usage and limits... quota(1) 
quotacheck: filesystem quota........ .«quotacheck(1M) 
quotactl: manipulate disk quotas ..quotactl(2SEQ) 


quotaoff: turn filesystem quotas on and off.....quotaon(1M) 


quotaon, quotaoff: turn filesystem quotaon(1M) 
quotas... edquota(1M) 
quotas... quotactl(2SEQ) 
quotas for a filesystem ..repquota(1M) 
quotas on and off.......... quotaon(1M) 
rand, srand: simple random-number... rand(3C) 
random inode generation numbers. ..fsirand(1M) 


random-number generator 


ratfor, or ef] files .....s.s0 fsplit(1) 
ratfor: rational Fortran dialect ratfor(1) 
rational Fortran dialect... ratfor(1) 


re: reboot and shutdown command... 
rc0: run commands performed to stop 
re2: run commands performed for. 
res; change RCS file attributes.. 


RCS file attributes. 
RCS file from SCCS file. 
RCS files... 


RCS revisions... 
RCS revisions.. 


RCS revisions...... ..resmerge(1) 
resdiff: compare RCS revisions.. ...resdifi{1) 
resfile: format of RCS file..... resfile(4) 


resintro: introduction to RCS -resintro(1) 
resmerge: merge RCS revisions. ..resmerge(1) 
TEA A PASSWOTT .....cssssseereeerseeeees ..getpass(3C) 
read an indexed symbol table entry Jdtbread(3X) 
read an indexednamed section. ... ldshread(3X) 
read constab entries into a..... .read_constab(3SEQ) 


read directory entries and put ina. 
read from file 
read mail..... 
read one line 
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of an archive file ldahread: 
object file ldfhread: 
readlink: 

readv: 


into a structure 

directory: opendir, 

gets longest line 

open a common object file for 
open: open for 

link 

readfile, longline: 


Iseek: move 

tirdwr: Transport Interface 
/get real user, effective user, 
/geteuid, getgid, getegid: get 
malloc, free, 
malloc, free, 
re: 
t_revudata: 
t_revuderr: 
t_rev: 
t_revconnect: 
lockf: 

ed, 

setcolor: 
ditsectbl: 
regular expression 


fast main memory/ 


over a connection 
connect request 


make: maintain, update, and 
expression regcmp, 
string 

and match routines 

regemp, regex: compile and execute 
regemp: 

regexp: 

a file for a pattern using full 


routines 


accept, 

comm: select or 

join: 

t_sndre]: initiate an orderly 
acknowledge receipt of an orderly 
“common object file 
ldrseek, Idnrseek: seek to 
reloc: 

/ceil, fmod, fabs: floor, ceiling, 
calendar: 

uuxqt: execute 

Uutry: try to contact 

ct: spawn getty toa 
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..read(2) 
ldahread(3X) 


read: read from file... 
read the archive header of a member. 


read the file header of a common .ldfhread(3X) 
read value of a symbolic link readlink(2SEQ) 
read vector from file.........csseseeee readv(2SEQ) 


.Tead_constab(3SEQ) 
directory(3X) 
readfile(1F) 
-Idopen(3X) 
TEAGING OF WFItiDG ....sssesssesseecesseseneeesesescnsersseerecnteeseeaes open(2) 
readlink: read value of a symbolic. 
reads file and gets longest line 
readv: read vector from file 
read/write file pointer........ 
read/write interface STREAMS module.. 
real group, and effective group IDs. 
real user, effective user, real/.......... 
realloc, calloc: main memory allocator. 
realloc, calloc, mallopt, mallinfo: 


read_constab: read constab entries. 
readdir, telldir, seekdir, rewinddir/.. 
readfile, longline: reads file and.. 


reboot and shutdown command SCTIPES.......sesseeseeseeeeeee re(4) 
receive a data UMIt.....cceeseseeeeeeee t_revudata(3N) 
receive a unit data error indication t_revuderr(3N) 
receive data or expedited data SCNt.....cssseeseeereee t_rev(3N) 
receive the confirmation from a.. t_reveonnect(3N) 
record locking on files.. lock {3C) 
red; text editor... wed(1) 
redefine or create a color. etcolor(1F) 
refresh security table...... ditsectbl(1M) 
regemp, regex: compile and execute regemp(3X) 
regemp: regular expression compile... «regemp(1) 
regenerate groups of programs.... make(1) 
regex: compile and execute regular. regemp(3X) 
regex: match patterns against a. .regex(1F) 
regexp: regular expression compile: regexp(5) 
regular expressiOn........-++0+- regemp(3X) 
regular expression compile regemp(1) 
regular expression compile and match. regexp(5) 
regular expressionS........scessrere .egrep(1) 
reinit: run an initialization file. reinit(1F) 
reject: allow or prevent LP requests accept(1M) 
reject lines common to two sorted files. .comm(1) 
relational database operator .-Join(1) 
Te]CA8C.....sesseeseenee .t_sndrel(3N) 
release indication... .t_revrel(3N) 
reloc: relocation information for ......cssesscseeeeereers reloc(4) 
relocation entries of a section of a common/. drseek(3X) 
relocation information for a common object file......reloc(4) 
remainder, absolute value functions. ..-floor(3M) 
TEMIUNET SETVICE.....eressseseee calendar(1) 
remote command requests -uuxqt(1M) 
remote system with debugging on... -uutry(1M) 


remote terminal 
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rmdel: 
rmdir: 
rmvopt: 
iperm: 
unlink: 
rm, rmdir: 
pwfix: 
deroff: 


set, or shared memory ID 
password entries 


consistency check and interactive 
uniq: report 
clock: 
fsstat: 

ipes: 

df: 

mailbug: submit a bug 

sar: sal, sa2, sadc: system activity 
timex: time a command; 

ps: 

uniq: 

fseek, rewind, ftell: 

filesystem 

submit a bug report or enhancement 
t_accept: accept a connect 

t_listen: listen for a connect 

the confirmation from a connect 
send user-initiated disconnect 
accept, reject: allow or prevent LP 
the LP print service and move 
uuxqt: execute remote command 

Ip, cancel: send/cancel 
to its default values 
reset: 
get_process_stats: get 
restore: incremental filesystem 
restore 

/ksh, rksh — KornShell, a standard/ 
sh, rsh: shell, the standard/ 
shadow: 

/m_rele_procs: suspend and 


facilities status 


default values 


usage examples usage: 
t_revdis: 

object file symbol table/ ldgetname: 
abs: 


logname: 
m_get_numprocs: 
m_get_myid: 
getenv: 

stat: data 
getitems: 
getfrm: 
cpus_online: 


marked menu items 
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remove a delta from an SCCS file... 
remove a directory....... 
remove a menu option... 
remove a message queue, semaphore. 
remove directory entry..... 
remove files or directories... 
remove incorrectly formatted. 
remove nroff, tbl, and eqn constructs.. 
rename: change the name of a file 


.rename(2) 


FOPAIUN ssissscscssssssrnssseseness .fsck(1M) 
repeated lines in a file uniq(1) 
report CPU time used..... clock(3C) 
report filesystem status .fsstat(1M) 
report inter-process communication -ipes(1) 


df(1M) 
mailbug(1) 


report number of free disk blocks and inodes.. 
report or enhancement request.. 
report package 
report process data and system activity. 
report process status 


.timex(1) 
+ ps(1) 


report repeated lines in a file.. uniq(1) 
reposition a file pointer in a stream. fseek(3S) 
repquota: summarize quotas for a ..repquota(1M) 
VOQUOSE siseccsssscvesercascaussvevasseaideronsaiees --mailbug(1) 


request.. .t_listen(3N) 
request .. _-rcveonnect(3N) 
request.. t_snddis(3N) 


requests 
requests..., 
requests 

requests to the LP print service . 
reset: reset the current form field. 
reset the current form field to its.. 
resource utilization info get_process_stats(2SEQ) 
restore... .restore(1M) 
restore: incremental filesystem.. -restore(1M) 
restricted command and programming/. -ksh(1) 
restricted command programming/.. sh(1) 
restricted password file........ -shadow(4) 
resume child process execution .. m_park_procs(3PPS) 


retrieve a command description and .... usage(1) 
retrieve information from disconnect... t_revdis(3N) 
retrieve symbol name for common. ldgetname(3X) 


return integer absolute value. 
return login name of user.... 
return number of child procs... 
return process identification... 
return value for environment name. 


logname(3X) 
m_get_numprocs(3PPS) 
..m_get_myid(3PPS) 
getenv(3C) 


returned by stat system call ......sssesssessssesssaeesesrenseee stat(5) 
returns a list of the currently.. getitems(1F) 
returns the current frame number .- getfrm(1F) 


epus_online(3PPS) 


returns the number of CPUs on-line. 
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col: filter 

ci: check in RCS 

co: check out RCS 

resdiff; compare RCS 

resmerge: merge RCS 

pointer in a stream fseek, 
/opendir, readdir, telldir, seekdir, 
creat: create a new file or 

restricted command/ ksh, 
information about RCS files 
directories 

mail, 

file 


rm, 


chroot: change 

chroot: change 

logarithm, power, square 

queue menumsg: 
ldfen: common object file access 
regular expression compile and match 
programming language sh, 
nice: 

nohup: 

shell: 

noage, nopff, noswap, onproc: 

the operating system boot: 
run: 
ede: 
reinit: 
setpgrp: 
re2: 
red: 
runacct: 


multi-user environment 
operating system 


Administration 
sar: 

sar: sal, 
editing activity 
sar: sal, sa2, 
report package 


savecore: 
operating system 
brk, 

brk, 

formatted input 
bfs: big file 

awk: pattern 
nawk: pattern 
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.resmerge(1) 
..fseek(3S) 
directory(3X) 


rewind, ftell: reposition a file 
rewinddir, closedir: directory/.. 


rlog: print log messages and other... 
rm, rmdir: remove files oF..........+ 
rmail: send mail to users or read mail.. 
rmdel]: remove a delta from an SCCS... 
rmdir: remove & directory.......-0-++ 
rmdir: remove files or directories 
Tmvopt: remove a menu option 
TOOE GEFECLOTY .ccosesesecesescasccessces 
root directory for a command. 
root functions.. 
route user message to menu message 
routines.... 

routines. 
rsh: shell, standard/restricted command/.. 
run a command at low priority ..........0008 
run a command immune to hangups and quits. 
run a command using shell... 
run a command with priority aging, 
run a standalone program or bring up.. 
TUN AN CXECULADIC.......ccscceseeecenseeeerseateceren 
run an externally described command.. 
run an initialization file... 
run command in its own process group. 
run commands performed for... 
run commands performed to stop the.. 
run daily accounting... 
run: run an executable 
runacct: run daily accounting..........++ 
SA: devices administered by System... 
sal, sa2, sade: system activity report package 
sa2, sade: system activity report package.... 
sact: print current SCCS file......sseserr 
sadc: system activity report package.. 
sar: sal, sa2, sadc: system activity. 
sar: system activity reporter. 
save a core dump of the operating system 
savecore: save a core dump of the. 
sbrk: change data segment space allocation........-..++ brk(2) 
sbrk: change private data segment size. -brk(3PPS) 
scanf, fscanf, sscanf: convert . scanf(3S) 
scanner.. .bfs(1) 
scanning and processing language.. awk(1) 
scanning and processing language.. -nawk(1) 


.«.rmvopt(1M) 
...chroot(2) 


‘menumsg(1M) 
icarel ldfen(4) 


..edce(1M) 
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change the delta commentary of an 
comb: combine 

delta: make a delta (change) to an 
get: get a version of an 

prs: print an 

rmdel: remove a delta from an 
scesdiff: compare two versions of an 
sccsfile: format of 

sccstorcs: build RCS file from 
unget: undo a previous get of an 
val: validate 

sact: print current 

admin: create and administer 
what: identify 

SCCS file 


file 

board 

ckbupscd: check filesystem backup 
transport program uusched: the 
unlock locks s_init_lock, s_lock, 
object file 

image file 

more: view a file one full 

curses: terminal 

scr_dump: format of curses 

vi: 

inittab: 

re; reboot and shutdown command 
tg: 

sd: 

wd: SSM 

CCSformat: standalone embedded 
tm: 

ts: 

SCED: 

getscsiinfo, getscsimatch: get 


program 

fgrep: 

grep: 

full regular expressions egrep: 
bsearch: binary 

acctcom: 

lsearch, Ifind: linear 

pathconv: 

hcreate, hdestroy: manage hash 
tfind, tdelete, twalk: manage binary 
manipulate the object file comment 
m_multi: mark single-process code 
senhdr: 

Adnshread: read an indexednamed 
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SCCS delta.. ad 

SCCS deltas. comb(1) 
SCCS file... delta(1) 
SCCS file. get(1) 
SCCS file. prs(1) 
SCCS file. rmdel(1) 
SCCS file. sccsdiff(1) 
SCCS file -sccsfile(4) 
SCCS file 

SCCS file unget(1) 
SCCS file .val(1) 
SCCS file editing activity. »sact(1) 
SCCS files .admin(1) 
SCCS files...... ...What(1) 


sccsdiff: compare two versions of an. 
scesfile: format of SCCS file........... 
sccstores: build RCS file from SCCS... 
SCED: SCSI/Ethernet/Diagnostics 
SCHEMUIC....eseeseesesseresseeseeees 
scheduler for the uucp file... 
s_clock, s_unlock: initialize, lock, 
senhdr: section header for a common.. 
scr_dump: format of curses screen 
SCTCCN At A LIMC....ccessereereescsenenenenensaes 

screen handling and optimization package 


.ckbupsed(1M) 
uusched(1M) 
.-8_lock(3PPS) 


screen image file... ..scr_dump(4) 
screen-oriented (visual) display editor based on ex......vi(1) 
script for the init process... 


inittab(4) 


SCTUPtS osssscsseossesscscsscassoneaces: 
SCSI 1/2-inch magnetic tape interface 
SCSI disk controller. 
SCSI disk controller... 
SCSI disk formatter.. 
SCSI tape controller. 
SCSI tape controller.. 
SCSI/Ethernet/Diagnostics board 
scsiinfo structure ......... 
sd: SCSI disk controller. 
sdiff: side-by-side difference... 
search a file for a character string. 
search a file for a pattern... 
search a file for a pattern using. 
search a sorted table... 
search and print process accounting file 
search and Update ...scsrscseseseesererreeets 
search Interpreter criteria for filename.. 
search tables... 
search trees. 


..sced(7) 
.getscsiinfo(3SEQ) 


section header for a common object file.. ....scnhdr(4) 


section header of a common object..... 
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/seek to line number entries of a 
/seek to relocation entries of a 
/ldnsseek: seek to an indexednamed 
ditsectbl: refresh 

task: global 

tasktbl: create 


/nrand48, mrand48, jrand48, srand48, 
acommon object/ Idsseek, ldnsseek: 


section of a/ ldlseek, Idnlseek: 

ldrseek, ldnrseek: 
a common object file ldohseek: 
object file ldtbseek: 


/opendir, readdir, telldir, 
sweepoff: enable/disable patrol 
shmget: get shared memory 

brk, sbrk: change private data 
shbrk, shsbrk: change shared data 
brk, sbrk: change data 
comm: 

greck: 

addformopt: add a form/ 
semctl: 

semop: 

iperm: remove a message queue, 
semget: get set of 


sorted files 


t_sndudata: 
putmsg: 
kill: 
tfnotify: 
t_snd: 

mail, rmail: 
t_snddis: 
lp, cancel: 
receive data or expedited data 
intro: introduction to 

dis386; disassemble 

SSM: System 

setsid: create 

ascii: map of ASCII character 
alarm: 

umask: 

stty, gtty: 

set, unset: 

sigstack: 

timezone: 
backup.info: backup 
setdtablesize: 

env: 


connection 


in core or in files 
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section of a common object file.........s.00 
section of a common object file.... 
section of a common object file 


+1 dlseek(3X) 
Idrseek(3X) 
Idsseek(3X) 


security table... .dltsectbl(1M) 
security table. «+.task(4) 
security table in shared memory. tasktbl(1M) 
BEd: SLTEAM EOF ....sscccscsceccerscessensnsessescssenceencerevereceacese sed(1) 
seed48, Icong48: generate uniformly/. ..drand48(3C) 
seek to an indexednamed scction of.. ldsseek(3X) 
seek to line number entries of a..... ldlseek(3X) 
seek to relocation entries of a section of a/. ldrseek(3X) 
seek to the optional file header of... -Idohseek(3X) 
seek to the symbol table of a common... ldtbseek(3X) 
seekdir, rewinddir, closedir/. directory(3X) 
seeks on DCC disks .sweepon(1M) 
segment identifier ..Shmget(2) 
segment size... «.brk(3PPS) 
segment size... .shbrk(3PPS) 


..brk(2) 
-comm(1) 
..greek(1) 
..addformopt(1M) 
semctl(2) 


segment space allocation... 
select or reject lines common to two.. 
select terminal filter....csssceceees 
SELECT window option to a menu.. 
semaphore control operations... 
semaphore operations........... 
semaphore set, or shared memory ID 
semaphores.... 
semct]: semaphore control operation 
semget: get set of semaphores... 
semop: semaphore operations. 
send a data unit 

send a message on a stream. putmsg(2) 
send a signal to a process or a group of processes......kill(2) 
send completion message... ..t{notify(1M) 
send data or expedited data over a 
send mail to users or read mail...... 
send user-initiated disconnect request .. 


“t_anddis(3N) 


send/cancel requests to the LP print Service... Ip(1) 
sent over a connection «t_rev(3N) 
Sequent system calls... ntro(2SEQ) 
Series 386 instructions dis386(3SEQ) 
Services! Module wisscscesscsersscccses casa ccsssosscataccisscbctescpeseess ssm(7) 
session and set process group ID. -setsid(2) 
BO Uisitacassessosesscveseccenssseseiesss ascii(5) 
set a process alarm clock.... -alarm(2) 


set and get file creation mas! 
set and get terminal state (defunct; 
set and unset environment variables. 
set anW/or get signal stack context.. 
set default system time zone . 
set definitions........00 -backup_info(4) 
set descriptor table size... .setdtablesize(2SEQ) 
set environment for command execution.....ssesseeesees env(1) 
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utime: 

umask: 

tesetpgrp: 

setgroups: 

cpset: copy file and 

m_set_procs: 

semget: get 

remove a message queue, semaphore 
Ipusers: 

setpgrp: 

setsid: create session and 

setlocale: 

tabs: 

tegetattr, tesetattr: get/ 

line discipline getty: 
line discipline uugetty: 
date: print and 

stty: 

stime: 

environment variables in core or in/ 
setuid, setgid: 

ulimit: get and 

a stream 

/toascci, _tolower, _toupper, 


size 
setuid, 
getgrent, getgrgid, getgrnam, 


crypt, 


/endmntent, getmntent, hasmntopt, 
process group 


getpwent, getpwuid, getpwnam, 
process group ID 

getspent, getspnam, 

profile: 

gettydefs: speed and terminal 
IDs 

user 

/getutid, getutline, pututline, 
setbuf, 

machine-independent fashion sputl, 
standard/restricted command/ 
/fgetspent, Ickpwdf, ulckpwdf: get 
putspent: write 


pwconv: installs and updates /etc/ 
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set file access and modification times... 


set file-creation mode mask....... uumask(1) 
set foreground process group ID tesetpgrp(2) 
set group access list .......eee setgroups(2SEQ) 


set mode, user, and group IDs.. -cpset(1) 
set number of child processes. ..m_set_procs(3PPS) 
set of semaphoreB.......ss000 .semget(2) 


set, or shared memory ID. 
set printing queue priorities. 
set process group ID.... 
set process group ID.... 
set programs location 
set tabs on a terminal 
set terminal state....... 
set terminal type, modes, speed, and... 
set terminal type, modes, speed, and. 
BEE the date sivsisssssssssscsssessssessis 
set the options for a terminal 
set time... 
set, unset: set and unse! 
set user and group IDs.. 
set user limits. ae 


..-iperm(1) 
-lpusers(1M) 


.tegetattr(2) 
.-. getty(1M) 


setbuf, setvbuf: assign buffering to .-8etbuf(3S) 
setchrclass: character handling... .ctype(3C) 
setcolor: redefine or create a color setcolor(1F) 
setdtablesize: set descriptor table setdtablesize(2SEQ) 
setgid: set user and group IDs. setuid(2) 
setgrent, endgrent, fgetgrent: get group/ getgrent(3C) 
setgroups: set group access list......ccsere setgroups(2SEQ) 
setjmp, longjmp: non-local goto ..ccssessesssecsenesssers setjmp(3C) 
setkey, encrypt: generate hashing encryption.......crypt(3C) 
setlocale: set programs location ..8etlocale(3C) 
setmnt: establish mount table .setmnt(1M) 
setmntent: get file system/....... -getmntent(3SEQ) 
setpgid: manipulate signal sets.. -» Setpgid(2) 
setpgrp: run command in its own.. ...8etpgrp(1) 
setpgrp: set process group ID...... ... Setpgrp(2) 
setpwent, endpwent, fgetpwent: get/. .getpwent(3C) 
setsid: create session and SCt...s.sssesssscsseseseorereseesoes setsid(2) 
setspent, endspent, fgetspent, Ickpwdf/.. getspent(3X) 
setting up an environment at login time ........00 

settings used by getty......sssese 


setuid, setgid: set user and group.. 
setup: initialize system for first. 
setutent, endutent, utmpname/. 
setvbuf: assign buffering to a stream.. 
sgetl: access long integer data in a... 
sh, rsh: shell, the.........sssssssee 
shadow password file entry. 
shadow password file entry.. 


... setup(1) 
.getut(3C) 


.getspent(3X) 
..putspent(3X) 


shadow: restricted password file... shadow(4) 
shadow with information frond... ...pweonv(1M) 
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shbrk, shsbrk: change 

tasktbl: create security table in 
shmalloc, shrealloc, shfree: 
shmctl: 

&@ message queue, semaphore set, or 
shmop, shmat, shmdt: 

shmget: get 

segment size 

shell: run a command using 
assign menu system as user login 
system: issue a 

csh: a 

/shutacct, startup, turnacct: 


shells: 

command programming/ sh, rsh: 
shmalloc, shrealloc, 
memory allocator 
shmop, 

operations 

shmop, shmat, 
identifier 
operations 

the machine 
shmalloc, 

shbrk, 

shutdown: 
/nulladm, pretmp, prdaily, prtacct, 
re: reboot and 
shutdown: system 
system state 
information file 
actions 

sigemptyset, sigfillset, 


allocator 


manipulate/ 


sigemptyset, sigfillsct, sigaddset, 
sigdelset, sigismember: manipulate/ 
sigismember/ sigemptyset, 
sigpause: signal management sigset, 
sigset, sighold, sigrelse, 

/sigfillset, sigaddset, sigdelset, 
sigsetjmp, 

login: 

pause: suspend process until 

specify what to do upon receipt of a 
sigsuspend: wait for a 

sigaction: examine and change 
sigcontext: get 

sigrelse, sigignore, sigpause: 
setpgid: manipulate 

sigdelset, sigismember: manipulate 
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shared data segment size. 
shared MEMOTY.....s.es00 
shared memory allocator... 
shared memory control operations. 
shared memory ID..........0+« 
shared memory operations 
shared memory segment identifier 
shbrk, shsbrk: change shared data 


..shbrk(3PPS) 


...Shmetl(2) 
.iperm(1) 
-shmop(2) 
..shmget(2) 
.«.shbrk(3PPS) 


(oh otc | [Reon mene nr a Se NSN One nnSNSeDeE a CAL OM EN shell(1F) 
shell... fmenush(1M) 
shell comman .system(3S) 
shell (command interpreter) wi like syntax... esh(1) 
shell procedures for accounting .acctsh(1M) 


.shell(1F) 
..shells(4) 


shell: run a command using shel. 
shell table... 


shell, the standard/restricted.. ..8h(1) 
shells: shell table .............::ecce00 ..shells(4) 
shfree: shared memory allocator. shmalloc(8PPS) 
shmalloc, shrealloc, shfree: shared... shmalloc(3PPS) 
shmat, shmdt: shared memory operations. .shmop(2) 
shmct]: shared memory control....... shmct](2) 
shmdt: shared memory operations -shmop(2) 
shmget: get shared memory segment’ shmget(2) 
shmop, shmat, shmdt: shared memory .shmop(2) 
showcfg: show the configuration of... .«.Showefg(1M) 
shrealloc, shfree: shared memory... shmalloc(3PPS) 
shsbrk: change shared data segment size........shbrk(3PPS) 
shut down system, change system stat hutdown(1M) 
shutacct, startup, turnacct: shell/.. -acctsh(1M) 
shutdown command scripts... sacnceontOe) 
shutdown information file... ..shutdown(4) 
shutdown: shut down system, change...........shutdown(1M) 
shutdown: system shutdown ..shutdown(4) 
sigaction: examine and change signal . sigaction(2) 
sigaddset, sigdelset, sigismembe: .Sigemptyset(2) 
sigcontext: get signal context. sigcontext(2SEQ) 
sigdelset, sigismember: manipulate/ ..sigemptyset(2) 
sigemptyset, sigfillset, sigaddset, ..sigemptyset(2) 
sigfillset, sigaddset, sigdelset, .. ..Sigemptyset(2) 
sighold, sigrelse, sigignore,.. . Sigset(2) 
sigignore, sigpause: signal... -sigset(2) 
sigismember: manipulate signal sets ..Sigemptyset(2) 
siglongjmp: non-local jumps. ..Sigsetjmp(3C) 
i login(1) 
.«-pause(2) 

-signal(2) 

sigsuspend(2) 

signal actions.. .Sigaction(2) 
signal context. sigcontext(2SEQ) 
area sigset(2) 

..Setpgid(2) 

..Sigemptyset(2) 
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receipt of a signal 

sigstack: set and/or get 

kill: send a 

sigpending: examine pending 
examine and change blocked 
ssignal, gsignal: software 
sighold, sigrelse, sigignore, 


blocked signals 

signal management _ sigset, sighold, 
sigignore, sigpause: signal/ 

jumps 

stack context 


atan2: trigonometric/ trig: 
m_single, m_multi: mark 

functions 

initialize barrier, wait at barrier 
s_unlock: initialize, lock, unlock/ 
sbrk: change private data segment 
getdtablesize: get descriptor table 
getpagesize: get system page 
setdtablesize: set descriptor table 
shsbrk; change shared data segment 
of object files 

interval 

interval 

s_init_lock, 

ttyslot: find the 

consmem, 

ssignal, gsignal: 

qsort: quicker 

tsort: topological 

sort: 


select or reject lines common to two 
bsearch: binary search a 
an object file list: produce C 


open file into the processs address 
unmap part of the processs address 
into processs virtual address 

brk, sbrk: change data segment 

ct: 

vfork: 

fspec: format 
signal: 
getty: set terminal type, modes, 
uugetty: set terminal type, modes, 
gettydefs: 

find spelling errors 

file 


memory efficient way 
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signal: specify what to do upon.. 
signal stack context 
signal to a process or a group of processes. 


signal(2) 
..sigstack(2SEQ) 
kill(2) 


signals... . 8igpending(2) 
signals ..Sigprocmask(2) 
signals .-88ignal(3C) 


sigpause: signal management ..8igset(2) 
sigpending: examine pending signals. . Sigpending(2) 
sigprocmask: examine and change .-8igprocmask(2) 
sigrelse, sigignore, sigpause; sigset(2) 
sigset, sighold, sigrelse,... sigset(2) 
sigsetjmp, siglongjmp: non-local! -sigsetjmp(3C) 
sigstack: set and/or get signal ..Sigstack(2SEQ) 
sigsuspend: wait for a signal. -sigsuspend(2) 
sin, cos, tan, asin, acos, atan,. ...trig(3M) 
single-process code section.. .m_single(3PPS) 
sinh, cosh, tanh: hyperbolic .....ssssssessessorsssesesseseseees sinh(3M) 


_wait_barrier(3PPS) 
s_lock(3PPS) 


s_init_barrier, s_wait_barrier 
s_init_lock, s_lock, s_clock,. 


size.. .-brk(3PPS) 
size getdtablesize(2SEQ) 
size. ..getpagesize(2SEQ) 
size setdtablesize(2SEQ) 
UZ iavissiases ttspsscusntontiatscsotsasccaasncnesvecasaioepussaaieausiaains shbrk(3PPS) 
size: print section sizes. see C and Lang Tools Binder 


sleep: suspend execution for an. .Bleep(1) 
sleep: suspend execution for... .Sleep(3C) 
s_lock, s_clock, s_unlock: initialize, lock/. _lock(3PPS) 
slot in the utmp file of the current user... ..ttyslot(3C) 
sm, ss: console memory drivers. .consmem(7) 
software signals.. ..8signal(3C) 
SOF... ..qsort(3C) 
BOP saceseseuvssvoss ..tgort(1) 


sort and/or merge files.. 
sort: sort and/or merge files 
sorted files... 


BOrted table......c.cecsssesscconsssesseceseesenssssesnsnesesenseseees bsearch(3C) 
source listing from. see C and Lang Tools Binder 
Sp: STREAMS pipe device .....s.sccsessssssssenssseereneestsecansnseesnses sp(7) 
space. -mmap(2SEQ) 
space munmap(2SEQ) 
space... pmap(7) 


space allocation... 
spawn getty to a remote terminal. 
spawn new process in a virtual. 
specification in text files... 
specify what to do upon receipt of a signal 
speed, and line discipline. 
speed, and line discipline 


speed and terminal settings used by getty........gettydefa(4) 


spell, hashmake, spellin, hashcheck: «spell(1) 
spellhist: unmatched spelling words... ..spellhist(4) 
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spell, hashmake, 

hashmake, spellin, hashcheck: find 
spellhist: unmatched 

csplit: context 

split: 

fsplit: 


uucleanup: uucp 

printf, fprintf, 

data in a machine-independent/ 
square root/ exp, log, log10, pow, 
sqrt: exponential, logarithm, power, 
rand, 

Arand48, nrand48, mrand48, jrand48, 
consmem, sm, 

scanf, fscanf, 


wp: 
wd: 


terminal multiplexor driver 
sigstack: set and/or get signal 

copy: perform a 

prtvtoc: print the VTOC of a 
dual-channel disk/ zdformat: 
CCSformat: 

dump: 

operating system boot: run a 
intro: introduction to system 
stdio: 

stdipc: flok: 

sh, rsh: shell, the 

operating system for beginning/ 
Ipsched, Ipshut, Ipmove: 

/pretmp, prdaily, prtacct, shutacct, 
call 


package 


stat: data returned by 
information 

ustat: get filesystem 

ff: list filenames and 

fsstat: report filesystem 
communication facilities 
ps: report process 

stat, Istat, fetat: get file 
feof, clearerr, fileno: stream 
uustat: uucp 

Ipstat: print information about the 
input/output package 
communication package 


waitpid: wait for a child process to 
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split a file into pieces.. 
split {77, ratfor, or efl files. 
split: split a file into pieces 
spool directory clean-up..... 
sprintf: print formatted output 
sputl, sgetl: access long integer.... 
sqrt: exponential, logarithm, power,... 
square root functions... 
srand: simple random-number generator 
srand48, seed48, lcong48: generate/. 
ss: console memory driverS........0 
sscanf: convert formatted input... 
ssignal, gsignal: software signals. 
SSM parallel} line printer interface. 
SSM SCSI disk controller.... 
SSM: System Services Module... 
st: Systech MTI-800/1600/1650. 
Stack CONLEXt ..rcssceeeserereees 
standalone data transfer 
standalone disk device... 
standalone disk formatter for 
standalone embedded SCSI disk formatter...... 
standalone memory dump 
standalone program or bring up the.. 
standalone utilities........srsseseseerees 
standard buffered input/output package.. 
standard interprocess communication.. 
standard/restricted command programming/. 
starter: information about the ........sscecseseeren 
start/stop the LP print service and move/. 
startup, turnacct: shell procedures/. 
stat: data returned by stat system.. 
stat, Istat, fstat: get file status.. 
stat system Call .......eeseseeees 
statfs, fetatfs: get filesystem . 
SLALISLICS.....s.ssreceeseerereereneees 
statistics for a filesystem 
status.. 


..prtvtoc(8) 
dformat(8) 


' acctsh(1M) 
-8tat(5) 


aeStat(5). 
.statfs(2) 
..ustat(2) 
.f1M) 
fsstat(1M) 


status. ipes(1) 
status. .»«ps(1) 
status. .o-Stat(2) 


..ferror(3S) 
uustat(1C) 
Ipstat(1) 
stdio(3S) 
»stdipe(3C) 
...Stime(2) 
wait(2) 


status inquirie: 
status inquiry and job control... 
status of the LP print service. 
stdio: standard buffered......... 
stdipe: ftok: standard interproces: 
stime: set time 
stop or terminate 
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Ipsched, Ipshut, Ipmove: start/ 
rc0: run commands performed to 
icheck: filesystem 


strnemp, strepy, strncpy/ string: 
/strnemp, strepy, strncpy, strlen, 
cleanup program 

string: streat, strdup, strncat, 
/strdup, strncat, strcmp, strncmp, 
/strchr, strrchr, strpbrk, strspn, 
strepy, strncpy,/ string: streat, 
felose, flush: close or flush a 

fopen, freopen, fdopen: open a 
reposition a file pointer in a 

getw: get character or word from a 
getmsg: get next message off a 

gets, fgets: get a string from a 

putw: put character or word on a 
putmsg: send a message on a 

puts, fputs: put a string ona 

setvbuf: assign buffering to a 

push character back into input 

sed: 

ferror, feof, clearerr, fileno: 


driver 

clone: open any minor device on a 
strclean: 

strerr: 

log: interface to 

poll: 

streamio: 

Transport Interface cooperating 
Interface read/write interface 
sp: 

streampty: 

strace: print 

streamtty: Generic 

1d0: 

driver interface 


long integer and base-64 ASCII 
tzset: convert date and time to 
convert floating-point number to 
fgrep: search a file for a character 
regex: match patterns against a 
gps: graphical primitive 

gets, fgets: get a 

puts, fputs: put a 

echo: put 

strpbrk, strspn, strespn, strtok: 
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-Ipsched(1M) 
..rc0(1M) 
icheck(1M) 


stop the LP print service and move/. 
stop the operating system 
storage consistency check.. 
strace: print STREAMS trace messages. 
streat, strdup, strncat, stremp.... 
strehr, strrehr, strpbrk, strspn/ 
strclean: STREAMS error logger. 
stremp, strocmp, strepy, strncpy/. 
strepy, strncpy, strlen, strchr/.. 
strespn, strtok: string operations.. 
strdup, strncat, strcmp, strncmp 


...puta(3S) 
.setbuf(3S) 
stream.. 
stream editor.. 
stream status inquiries... 
streamio: STREAMS ioctl commands. 
streampty: STREAMS pseudo termina’ 
STREAMS iver ....sssossssessscersscsscnerernenes 
STREAMS error logger cleanup program.... 
STREAMS error logger daemon..........+ 
STREAMS error logging and event tracing 
STREAMS input/output multiplexing... 
STREAMS ioctl commands. 


..ferror(3S) 
..8treamio(7) 
streampty(7) 
asi clone(7) 


STREAMS module. timod(7) 
STREAMS module. tirdwr(7) 
STREAMS pipe GeVICC......scccsessssssesssnserserersessosarsesensesnacsnnns sp(7) 
STREAMS pseudo terminal driver... streampty(7) 
STREAMS trace messages... strace(1M) 
STREAMS tty driver interface. streamtty(7) 
STREAMS tty line discipline ......csssssssesesrerersesesecssecesenes 1d0(7) 
streamtty: Generic STREAMS tty.. streamtty(7) 
strerr: STREAMS error logger daemon strerm(1M) 
strftime: format time information... strftime(3C) 
string... a641(3C) 
string.. .ctime(3C) 
string.. ...ecvt(3C) 
string.. 


string... 
string, format of graphical files.. 
string from a stream 
string on a stream.... 
string on virtual output. 
string operations. 


-puts(3S) 
echo(1F) 
string(3C) 
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stremp, strncmp, strcpy, strncpy/ 
strtod, atof: convert 

strtol, atol, atoi: convert 

cftime: language specific 

object file 

/strcmp, strncmp, strepy, strncpy, 
string: streat, strdup, 

/streat, strdup, strncat, strcmp, 
/strncat, stremp, strncmp, strepy, 
/strncpy, strlen, strehr, strrchr, 
/strepy, strncpy, strlen, strchr, 
/strien, strchr, strrchr, strpbrk, 
character. 

double-precision number 

strrchr, strpbrk, strspn, strespn, 
to integer 

processes using a file or file 
getscsimatch: get scsiinfo 
getzdinfobyname: get zdinfo 

read constab entries into a 
t_alloc: allocate a library 

t_free: free a library 

state (defunct) 


backup.codes1; backup 

m_fork: execute a 

dbm_clearerr, dmb_blkflush: database 
plot: graphics interface 

sulog: log of 


of a file 

du: 

repquota: 

acctcms: command 
s_init_lock, s_lock, s_clock, 
sync: update the 

sync: update 

su: become 

getgroups: get 

uucp: networking 

Iptypes: table of printer types 
m_park_procs, m_rele_procs: 
sleep: 

sleep: 

pause: 


records 


s_init_barrier, 
swap: 
swab: 


wait at barrier 


/a command with priority aging, PFF, 
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string: streat, strdup, strncat, .... 
string to double-precision number. 
string to integer.......... 


strtol(3C) 
...cftime(4) 


BETIS .......0000 
strip: strip an. see C and pict Tools Binder 
strlen, strchr, strrehr, strpbrk,/.....sscsssesseee 


strncat, stremp, strncmp, strepy, strncpy/.. 
strnemp, strepy, strncpy, strlen/. 
strnepy, strlen, strchr, strrchr/. 
strpbrk, strspn, strespn, strtok/.. 
strrehr, strpbrk, strspn, strcspn/ 
strspn, strespn, strtok: string/. 
strstr: find first occurrence o 
strtod, atof: convert string to 
strtok: string operations....... 
strtol, atol, atoi: convert string 


structure... 
structure .. 
structure .. 
structure.. 
structure.. 
stty, gtty: set and get terminal 
stty: set the options for a terminal. 
su: become superuser or another use 
subcode definitions....... 
subprogram in paralle 
subroutines . 
subroutines. 
substitute user events. 
sulog: log of substitute user events. 
sum: print checksum and block count 
summarize disk USAGC........se0ceeeeee 
summarize quotas for a filesystem 
summary from per-process accounting 
s_unlock: initialize, lock, unlock locks.. 
superblock .. 
superblock... 
superuser or another user. 
supplementary group IDs. 
BUpPPOrt files.......sereeeerereeee 
supported by the menu system 


..getzdinfo(3SEQ) 
..read_constab(3SEQ) 
icespesessaenad t_alloc(3N) 
..t_free(3N) 


.acctems(1M) 
-s_lock(3PPS) 


suspend execution for an intervals, 
suspend execution for interval. 
suspend process until signal. 
Swab: BWAP DYtES.....csseeeereeeee 
s_wait_barrier: initialize barrier,.. 
swap administrative interface. 


swap: swap administrative interface 
swapping, or processor migration/ 


-noage(1M) 
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seeks on DCC disks sweepon, 
patrol seeks on DCC disks 

symbol table/ Idgetname: retrieve 
symbol name for common object file 
ldtbindex: compute the index of a 
ldtbread: read an indexed 

syms: common object file 

ldtbseek: seek to the 

unistd: file header for 

readlink: read value of a 

symlink: make 

of common operating system terms and 
file 

table format 


controlling FMLI object vsig: 
t_sync: 

check documents for correct eqn 
(command interpreter) with C-like 


administration 


variables 
configuration file 
perror, errno, 


menu system functions 

perror, errno, sys_errlist, 
multiplexor driver st: 
Ip: 

bsearch: binary search a sorted 
constab: constructed devices 
devtab: virtual device 

ditsectbl: refresh security 

kernel auto-configuration device 
fstab: file-system- 

mnttab: mounted filesystem 
setmut: establish mount 

shells: shell 

task: global security 

name for common object file symbol 
/compute the index of a symbol 
ldtbread: read an indexed symbol 
syms: common object file symbol 
tasktbl: create security 

get maximum in-use descriptor 
ldtbseek: seek to the symbol 

the menu system Iptypes: 
getdtablesize: get descriptor 
setdtablesize: set descriptor 
classification and conversion 
hdestroy: manage hash search 
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sweepoff: enable/disable patrol 
sweepon, sweepoff: enable/disable. 
symbol name for common object file.. 
symbol table entry.......sscssserseerees 
symbol table entry of a common/ 
symbol table entry of a common object/. 
symbol table format.......sssesssseseees 
symbol table of a common object file.. 
symbolic constants... 
symbolic link ... 
symbolic link to a 


symlink: make symbolic link to a.. 
syms: common object file symbol... 
sync: update superblock....... 
sync: update the superblock .. 
synchronize a co-process with the... 
synchronize transport library. 
syntax. 
syntax. 
sysadm: menu interface to do system, 
syscall: indirect system call......... 
sysconf: get configurable system. 
sys_config: format of a system. 
sys_errlist, sys_nerr: system error messages.. 
sysi86: machine specific functions. 
syskeymap: identify keys to internal. 


sys_nerr: system error message... perror(3C) 
Systech MTI-800/1600/1650 terminal. +8t(7) 
Systech parallel line printer interface 1p(7) 


table Entry .crscscsesscssseseerenen 
table entry of a common object file. 
table entry of a common object file. 
table format.....ssssecseses 
table in shared memory. 
table index......cssseseees 
table of a common object file 
table of printer types supported by.. 


.tasktbl(1M) 
ablemax(2SEQ) 
dtbseek(3X) 
.lptypes(4) 
.getdtablesize(2SEQ) 
.setdtablesize(2SEQ) 
...chrtbl(1M) 
-hsearch(3C) 
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tabs: set 


ctags: create a 

file 

structure 

trig: sin, cos, 

sinh, cosh, 

tm: SCSI 

ts: SCSI 

hpio: Hewlett-Packard 2645A terminal 
tar: 

mtio: UNIX magnetic 

tg: SCSI 1/2-inch magnetic 

xt: Xylogics 472 MULITBUS magnetic 
mt: magnetic 


shared memory 
transport endpoint 
deroff: remove nroff, 
terminal state 
group ID 


with another transport user 
tegetattr, 

group ID 

tsearch, tfind, 


4014: paginator for the 

init, 

directory: opendir, readdir, 

temporary file tmpnam, 
tmpfile: create a 

tmpnam, tempnam: create a name fora 
terminals 

term: format of compiled 


captoinfo: convert a 
base 

paginator for the Tektronix 4014 
special functions of the DASI 450 
ct: spawn getty to a remote 
ctermid: generate filename for 
hangup the specified controlling 
stty: set the options for a 

tabs: set tabs on a 

tty: get the name of the 

ttyname, isatty: find name ofa 
/associated with a terminal or the 
termcap: 
terminfo: 


description 
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tabs on a terminal... 
tabs: set tabs on a termina 
t_accept: accept a connect request... 
tags file... 


tail: deliver the last part Of 8 ....s..sssssssssssecssssssensecssseeee tail(1) 
t_alloc: allocate a library...... t_alloc(3N) 
tan, asin, acos, atan, atan2: trigonometric/. trig(3M) 


tanh: hyperbolic functions. 
tape controller... 
tape controller. 
tape file archiver 
tape file archiver 
tape interface. 
tape interface... 
tape interface.....scsesseeeeeeeees 
tape manipulating program.. 
tar: tape file archiver...... 
task: global security table.. 
tasktbl: create security table in 
t_bind: bind an address to a.. 
tbl, and eqn constructs... 
tegetattr, tcsetattr: get/set.. 
tegetpgrp: get foreground process 
t_close: close a transport endpoint... 
t_connect: establish a connection 
tesetattr: get/set terminal state... 
tesetpgrp: set foreground process. 
tdelete, twalk: manage binary search trees.. 
tee: pipe fitting... 
Tektronix 4014 termin: 
telinit: process control initializatio 
telldir, seekdir, rewinddir,/ 
tempnam: create a name for a. 
temporary file.. 
temporary file... 
term: conventional names for 


""t_bind(3N) 
.-derofM(1) 


.tegetpgrp(2) 
..t_close(3N) 
_connect(3N) 
..tegetattr(2) 
.tcsetpgrp(2) 
..tsearch(3C) 


term: format of compiled term file .. 
termcap description into a terminfo... 
termcap: terminal capability data .. 
terminal 
terminal.. 
terminal 
terminal 
terminal 
terminal... 
terminal... 
terminal 
terminal... 

terminal associated with a device 
terminal capability data base... 
terminal capability database.... 


ttydevname(1) 
..termeap(4) 
..terminfo(4) 
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streampty: STREAMS pseudo 

greek: select 

tty: controlling 

termio: general 

dial: establish an out-going 

st: Systech MTI-800/1600/1650 

xs: Xylogics 781 

tput: initialize a 

/get the device associated with a 
optimization package curses: 
gettydefs: speed and 

tegetattr, tcsetattr: get/set 

stty, gtty: set and get 

hpio: Hewlett-Packard 2645A 

line discipline getty: set 
line discipline uugetty: set 
functions of DASI 300 and 300s 
getpseudotty: get pseudo 

special functions of Hewlett-Packard 
term: conventional names for 

wait for a child process to stop or 
kill: 

exit, _exit: 

tic: 

tput: initialize a terminal or query 
convert a termcap description into a 
infocmp: compare or print out 
database 


of common operating system 


isnan: isnand, isnanf: 

ed, red: 

ex: 

edit: 

errormsg: error message 

newform: change the format ofa 
fspec: format specification in 
isismgr: ISIS file manager, updates 
plock: lock process, 
tsearch, 

reporter 

login shell 


search trees 


interface 
service information 


merge: 


batch: execute commands at a later 
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terminal driver... 
terminal filter... 
terminal (gentty) interface. 
terminal interface 
terminal line connection. 
terminal multiplexor driver 
terminal multiplexor driver... 


terminal or query terminfo database “tput(1) 
terminal or the terminal associated/ tydevname(1) 
terminal screen handling and... ...curses(3X) 
terminal settings used by getty. gettydefs(4) 
terminal state 


.tegetattr(2) 
terminal state (defunct). ad 
terminal tape file archiver.. 
terminal type, modes, speed, and.. 
terminal type, modes, speed, and.. 
terminals... 


terminate... 
terminate a process 
terminate process... 
terminfo compiler... 


terminfo database... ..tput(1) 
terminfo description.. captoinfo(1M) 
terminfo descriptions infocmp(1M) 
terminfo: terminal capability. .terminfo(4) 
termio: general terminal interface. .termio(7) 
terms and SyMboIS ......ssesseseesees ..glossary(1) 
t_error: produce error message. .t_error(3N) 
test: condition evaluation command ..test(1) 


test for floating-point NaN/ 
text editor.. 
text editor.. 
text editor (variant of ex for casual users). 
text file... 


.isnan(3C) 


errormsg(4) 


text file -newform(1) 
text files. ...fapec(4) 
text files in ISIS file format.. isismgr( 1M) 
text, or data in memory...... a+«-plock(2) 


tfind, tdelete, twalk: manage binary. .tsearch(3C) 
tfipe: interprocess communication... 
tfmenush: assign menu system as user.. 
tfnotify: send completion message 
t_free: free a library structure.. 
tg: SCSI 1/2-inch magnetic tape. 
t_getinfo: get protocol-specific.... 
t_getstate: get the current state 
three-way file Merge.......cssessseever 
tic: terminfo compiler 
PEM C ssc ccsececcesssosse seraseees 
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view a file one full screen at a 


setting up an environment at login 
stime: set 

time: get 

time, ptime: 

and system activity timex: 


acctcon1, acctcon2: connect- 


strftime: format 
profil: execution 


mktime, tzset: convert date and 
clock: report CPU 

timezone: set default system 

times: get process and child process 
set file access and modification 
times 

update access and modification 
process data and system activity 
zone 

cooperating STREAMS module 
read/write interface STREAMS module 
request 

a transport endpoint 


processor 


temporary file 

Aisgraph, isascii, tolower, toupper, 
/tolower, _toupper, _tolower, 

conv: toupper, tolower, _toupper, 
/isascii, tolower, toupper, toascci, 
Aispunct, isprint, isgraph, isascii, 
conv: toupper, 

endpoint 

tsort: 

transport endpoint 

acctmerg: merge or add 
modification times of a file 
/tolower, toupper, toascci, _tolower, 
/isprint, isgraph, isascii, tolower, 
conv: toupper, tolower, 

_tolower, toascii: translate/ conv: 
terminfo database 


ptrace, mptrace: process 

strace: print STREAMS 

to STREAMS error logging and event 
copy: perform a standalone data 
init.d: system level 

_toupper, _tolower, toascii: 
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time more(1) 
time -profile(4) 
time. .. stime(2) 


time a command.. 
time a command; report process data 
time accounting 
time: get time... 
time information. 
time profile 
time, ptime: time a comman 
time to string 


weeetime(2) 
..strftime(3C) 


time used, 
time zone.. 
times. ..times(2) 
times .-utime(2) 


..times(2) 
ouch(1) 


times: get process and child proces: 
times Of a file ....secssoessersesesseenencees 


timex: time a command; report. .-timex(1) 
timezone: set default system tim imezone(4) 
timod: Transport Interface... timod(7) 


tirdwr: Transport Interface 
t_listen: listen for a connect... 


t_look: look at the current event on _look(3N) 


tm: SCSI tape controller.. tm(7) 
tmp_affinity: bind a process to a.. mp_affinity(2SEQ) 
tmp_ctl: multi-processor control.. .tmp_ctl(2SEQ) 
tmpfile: create a temporary file ...tmpfile(3S) 
tmpnam, tempnam: create a name for a.. .tmpnam(3S) 
toascci, _tolower, _toupper/... ctype(3C) 
toascii: translate characters.. wconv(3C) 
_tolower, toascii: translate/..... +. conv(3C) 
_tolower, _toupper, setchrclass/... ctype(3C) 
tolower, toupper, toascci, _tolower/. ..ctype(3C) 


tolower, _toupper, _tolower, toascii: translate/......conv(3C) 
t_open: establish a transport. t_open(3N) 
topological sort..... ..tsort(1) 
t_optmgmt: manage options for a 
total accounting files 
touch: update access and.. 
_toupper, setchrclass: character’... 
toupper, toascci, _tolower,/........ 
_toupper, _tolower, toascii: translate/. 
toupper, tolower, _toupper, .conv(3C) 
tput: initialize a terminal or query .. .tput(1) 
tr: translate Characters...ccscscssssesessessserscenencansnenneseensonees tr(1) 
trace facility...... ptrace(2) 
trace messages. -strace(1M) 
tracing... aaa 

transfer 
transition files directory... 
translate characters.. 


..ctype(3C) 
ctype(3C) 
..conv(3C) 
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tr: 

t_bind: bind an address to a 

t_close: close a 

look at the current event on a 
t_open: establish a 

t_optmgmt: manage options for a 
t_unbind: disable a 

STREAMS module timod: 
interface STREAMS module _ tirdwr: 
t_sync: synchronize 

the scheduler for the uucp file 
uucico: file 

establish a connection with another 
data sent over a connection 
confirmation from a connect request 
disconnect 

orderly release indication 


error indication 

ftw: walk a file 

tdelete, twalk: manage binary search 
atan, atan2: trigonometric’ 

cos, tan, asin, acos, atan, atan2; 


truncate, ftruncate: 

to a specified length 

u3b2, u3b5, vax: get processor type 
true, false: provide 


manage binary search trees 
over a connection 
disconnect request 

release 


library 
interface 
streamtty: Generic STREAMS 


1d0: STREAMS 

between major/minor numbers and 
associated with a terminal or the/ 
terminal 
dev_to_ttyname, 

file of the current user 
endpoint 

vmtune: 

tunefs: 

filesystem 

examine and change virtual memory 
/prdaily, prtacct, shutacct, startup, 
tsearch, tfind, tdelete, 


major/minor/ 


parameters 
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translate characters... 
transport endpoint. 
transport endpoint.. 
transport endpoint 
transport endpoint... 
transport endpoint.... 
transport endpoint... 
Transport Interface cooperating.. 
Transport Interface read/write. 
transport library... 
transport program. 
transport program for the uucp system. 
LYANSPOTTt USET......c..eecseereseereeseees 
t_rev: receive data or expedited 
t_revconnect: receive the............ 
t_revdis: retrieve information from 
t_revrel: acknowledge receipt of an. 
t_revudata: receive a data unit .. 
t_revuderr: receive a unit data. 
tree.. 


_close(3N) 
t_look(3N) 


t_revrel(3N) 
__revudata(3N) 


trig: sin, cos, tan, asin, acos,.. 
trigonometric functions... 
true, false: provide truth values 
truncate a file to a specified length. 
truncate, ftruncate: truncate a fil 
truth value... 
truth values.. 


‘truncate(2SEQ) 
.truncate(2SEQ) 
.machid(1) 


ts: SCSI tape controller. +t8(7) 
tsearch, tfind, tdelete, twalk:. “tsearch(3C) 
t_snd: send data or expedited data.. t_snd(3N) 


t_snddis: send user-initiated... 
t_sndrel: initiate an orderly... 
t_sndudata: send a data unit. 
tsort: topological sort ......... 
t_syne: synchronize transport. 
tty: controlling terminal (gentty). 


tty driver interface ........scssseeseeee: 

tty: get the name of the terminal. .tty(1) 
tty line discipline........csessesesssveee .1d0(7) 
tty names. dev_to_ttyname(3C) 
ttydevname: get the device .. ttydevname(1) 
ttyname, isatty: find name Of 8.......scsssessereeeers ttyname(3C) 
ttyname_to_dev: convert between.......dev_to_ttyname(3C) 


ttyslot: find the slot in the utmp. 
t_unbind: disable a transport... 
tune system-wide virtual-memory 
tune up an existing filesystem 
tunefs: tune up an existing. 
tuning parameters ..........00 
turnacct: shell procedures for“... 
twalk: manage binary search trees.. 


.-ttyslot(3C) 
_unbind(3N) 


"vm_ctl(2SEQ) 
acctsh(1M) 
.tsearch(3C) 
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types: primitive system data 
Iptypes: table of printer 

/asctime, cftime, ascftime, mktime, 
machid: i386, ns32000, pdp11, 
machid: i386, ns32000, pdp11, u3b, 
/i386, ns32000, pdp11, u3b, u3b2, 
/endspent, fgetspent, Ickpwdf, 
mask 


mount, 


mountall, 
system 


filesystems 


expand data compress, 
unget: 

SCCS file 

input stream 

file 

mktemp: make a 
constants 
t_revudata: receive a data 
t_sndudata: send a data 
t_revuderr: receive a 


mtio: 

cu: call another 

link, unlink: link and 
link, 


m_lock, m_unlock: lock, 

s_clock, s_unlock: initialize, lock, 
space munmap: 
spellhist: 

umount: 

mount, umount: mount and 
mountall, umountall: mount, 

pack, peat, 

set, unset: set and 

variables in core or in files set, 
lsearch, Ifind: linear search and 
touch: 

make: maintain, 

bdflush: 

bdflush: 

syne: 

sync: 


from/ pwconv: installs and 
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types... 
types: primitive system data types. 
types supported by the menu system. 
tzset: convert date and time to/........... 
u3b, u3b2, u3b5, vax: get processor type/. 
u3b2, u3b5, vax: get processor type/.. 
u3b5, vax: get processor type truth/ 
uadmin: administrative control .. 
uadmin: administrative control.. 
ulckpwdf: get shadow password file entry 
ulimit: get and set user limits 
umask: set and get file creation 
umask: set file-creation mode mask. 
umount: mount and unmount filesystems 
umount: unmount a filesystem... 
umountall: mount, unmount multip! 
uname: get name of current operating... 
uname: print name of current system 
uncompress, zcat: compress and. 
undo a previous get of an SCCS file. 
unget: undo a previous get of an.. 
ungetc: push character back into 


.-machid(1) 
.-machid(1) 
suadmin(1M) 
.uadmin(2) 
.getspent(3X) 
ulimit(2) 


unig: report repeated lines in A....c..sscessessesesessecsesonss uniq(1) 
unique filename ......sesesesescees -mktemp(3C) 
unistd: file header for SyMbOIiC......ccsssssessoneessseeeneee unistd(4) 
unit. t_revudata(3N) 
unit. _sndudata(3N) 
unit data error indication t_revuderr(3N) 
units: conversion program.. «units(1) 


UNIX magnetic tape interface... 
UNIX SYStOM .....ccerererserenensee: 
unlink files and directories. 
unlink: link and unlink files and directories 
unlink: remove directory entry. 
unlock locks. 
unlock locks. 


mM “lock(3PPS) 
s_lock(3PPS) 
-munmap(2SEQ) 
..spellhist(4) 
-umount(2) 


unmatched spelling words file... 
unmount a filesystem... 


unmount filesystems.... .«mount(1M) 
unmount multiple filesystem: .-mountall(1M) 
unpack: compress and expand files. ..-pack(1) 


set(1F) 
..set(1F) 
search(3C) 
-touch(1) 


unset environment variables in core or in files... 
unset: set and unset environment 
update 
update access and modification times of a file 


update, and regenerate groups of programs -make(1) 
update daemon... ..bdflush(1M) 
update daemon... .bdflush(2SEQ) 


update superblock. .syne(2) 
update the superbloc! syne(1M) 
updates /etc/shadow with information -pweonv(1M) 
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isismgr: ISIS file manager, 

been up 

du: summarize disk 

quota: display disk 

retrieve a command description and 
description and usage examples 


getusclk, 

get character login name of the 
logname: return login name of 
setup: initialize system for first 

su: become superuser or another 

a connection with another transport 
slot in the utmp file of the current 
write: write to another 

epset: copy file and set mode, 
setuid, setgid: set 

id: print 

crontab: 

addusr.def: add 

/geteuid, getgid, getegid: get real 
environ: 

run commands performed for multi- 
sulog: log of substitute 

generate disk accounting data by 
ulimit: get and set 

tfmenush: assign menu system as 
menumsg: route 

edquota: edit 

/getegid: get real user, effective 
t_snddis: send 

editor (variant of ex for casual 

the operating system for beginning 
wall: write to all 

ut_delete_user: add/delete 

mail, rmail: send mail to 

login attempts 


add/delete users in utmp file 

utmp file ut_add_user, 
introduction to system standalone 
get_process_stats: get resource 
modification times 

utmp, wtmp: 

ut_delete_user: add/delete users in 
endutent, utmpname, getutpid: access 
ttyslot: find the slot in the 

formats 

/pututline, setutent, endutent, 

and permissions file 

the uucp system 

clean-up 
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updates text files in ISIS file format...........000+ isismgr(1M) 
uptime: show how long system has... -uptime(1) 
UBSAZE™ vecscscesoeeeees wi 

usage and limits.. 
usage examples 
usage: retrieve a command.. 
usclk: 32-bit microsecond counter. 
usclk_init: get/init microsecond clock . 
user... 
user... 
user.. 
user... 


“getusclk(3SEQ) 
..cuserid(3S) 


connect(3N) 
tyslot(3C) 
«.. write(1) 
cpset(1) 
..setuid(2) 
.id(1M) 
..crontab(1) 
addusr_def(4) 

wasad getuid(2) 
environ(5) 


user... 
user, and group IDs.. 
user and group IDs. 
user and group [Ds and names 
user crontab file...... 
user defaults........ 
user, effective user, real group/. 
user environment... 
user environment. 
user events 
user ID... 
user limits. 
user login shell. 
user message to menu message queue. 
USCT QUOLAS...cecsssssesessessacereereeese 
user, real group, and effective/... 
user-initiated disconnect request... 
users)... 
users. 


menumsg(1M) 
..edquota(1M) 
.getuid(2) 
..t_snddis(3N) 

sane’ edit(1) 


users 

users in utmp file. utadduser(3X) 
users Or read Mail... sesssssssssssesessecseseseseataseeesencee mail(1) 
/usr/adm/oginlog: log of failed/. loginlog(4) 
ustat: get filesystem statistics..........csessscsssecseseeseres ustat(2) 
ut_add_user, ut_delete_user:.. utadduser(3X) 
ut_delete_user: add/delete users in.. utadduser(3X) 


utilities 
utilization informatio: 
utime: set file access and... 
utmp and wtmp entry formats. 


..get_process_stats(2SEQ) 
utime(2) 


..ttyslot(3C) 
.-utmp(4) 
getut(3C) 
.uucheck(1M) 
uucico( 1M) 
-uucleanup(1M) 


utmp file of the current user.... 
utmp, wtmp: utmp and wtmp entry.. 
utmpname, getutpid: access utmp file/. 
uucheck: check the uucp directories. 
uucico: file transport program for... 
uucleanup: uucp spool directory... 
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ayn nnn 


uucheck: check the 
uusched: the scheduler for the 


uucleanup: 

uustat: 

file transport program for the 
UNIX-to-UNIX system/ 
speed, and line discipline 
uucp, 

uucp, uulog, 

uuto, 

file transport program 
control 

UNIX-to-UNIX system/ 

with debugging on 

system command execution 
requests 


val: 


abs: return integer absolute 

u3b5, vax: get processor type truth 
getenv: return 

floor, ceiling, remainder, absolute 
readlink: read 

putenv: change or add 

current form field to its default 
true, false: provide truth 

values: machine-dependent 


print formatted output of a 

list 

varargs: handle 

fpathconf: get configurable pathname 
sysconf: get configurable system 
.environ, .pref, 

unset: set and unset environment 
edit: text editor ( 

proc_ctl: control over 

/ns32000, pdp11, u3b, u3b2, u3b5, 


get option letter from argument 
readv: read 

writev: write 

assert: 

ve: 

get: geta 

sccsdiff: compare two 

virtual memory efficient way 


output of a varargs/ vprintf, 
editor based on ex 
more: 
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uucp directories and permissions file. uucheck(1M) 


uucp file transport program.... ..uusched(1M) 
uucp: networking SUPpOrt fileS.....ssseeseseressseeseseneces uucp(4) 
uuep spool directory clean-up .... .uucleanup(1M) 
uucp status inquiry and job control.. ..uustat(1C) 
UUCP BYSEM ....eeeseeee .-uucico(1M) 
uucp, uulog, vunam: ..uucp(1C) 


uugetty: set terminal type, modes, 
uulog, uuname: UNIX-to-UNI¥/. 
uuname: UNIX-to-UNIX system copy. 
uupick: public UNIX-to-UNIX/......... 
uusched: the scheduler for the uucp. 
uustat: uucp status inquiry and job.. 
uuto, UUpICk: PUDIIC....cceeeesereeeeees 
Uutry: try to contact remote system. 
uux: UNIX-to-UNIX.. 
uuxqt: execute remote command, 
val; validate SCCS file... 


“wucp(1C) 
..wuto(1C) 
..-uusched(1M) 


.oval(1) 


validate SCCS file..... .val(1) 
valloc: aligned memory allocator... .valloc(3SEQ) 
value ...abs(3C) 
value machid(1) 
value for environment name.. getenv(3C) 
value functionsS.........00008 ..floor(3M) 
value of a symbolic link “readlink(2SEQ) 
value to environment. .._putenv(3C) 

.reset(1F) 


values: machine-dependent value: 
varargs argument list......csseeseee 
varargs: handle variable argument.. 


vprint{{3S) 
varargs(5) 


variable argument list... varargs(5) 
variables... ..pathcon{(2) 
variables. .sysconf{(2) 


-variables: FACE files. 
variables in core or in 
variant of ex for casual users) 
various process attributes...... 
vax: get processor type truth value... 


..Proc_ etl(2SEQ) 
-machid(1) 


VC! VETSION CONETO] ....sessssseressessresetserersneareceseeeceransneesoranenee ve(1) 
VECLOT..roseeececeees getopt(3C) 
vector from file readv(2SEQ) 


.writev(2SEQ) 
assert(3X) 
.ve(1) 


vector on a file.. 
verify program assertion . 
version CONntrOl......-ssee 


version of an SCCS file... -get(1) 
versions of an SCCS file.. .secsdif1) 
vfork: spawn new process in a »+Wfork(2) 
vfprintf, vsprintf: print formatted vprint{{(3S) 


--Vi(1) 
-more(1) 


vi: screen-oriented (visual) display.. 
view a file one full screen at a time. 
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map physical addresses into processs 
devtab: 

devdestroy: build and destroy 

vfork: spawn new process in a 
vm_ctl: examine and change 

echo: put string on 

controlling terminal fvhangup: 
vmtune: tune system-wide 

pmap: display or alter parameters of 
vi: screen-oriented 

memory tuning parameters 
virtual-memory parameters 
filesystem 

fs, inode: format of file system 
formatted output of a varargs/ 

the controlling FMLI object 

a varargs/ vprintf, vfprintf, 
prtvtoc: print the 

prtvtoc: print the 

mkvtoc: populate 

vtoc: 


s_wait_barrier: initialize barrier, 


wait, waitpid: 

sigsuspend: 

process to stop or terminate 

stop or terminate wait, 
ftw: 


whodo: 
who: 


vmtune: tune system- 
addformopt: add a form/SELECT 
we: 

fgetc, getw: get character or 
fputc, putw: put character or 
spellhist: unmatched spelling 

cd; change 

chdir: change 

getcwd: get pathname of current 
pwd: 

specific alarms and/or the 
interface 

Iseek: move read/ 

tirdwr: Transport Interface read/ 
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virtual address space.... ..pmap(7) 
virtual device table -devtab(4) 
virtual devices........ ..devbuild(1M) 
virtual memory efficient WAY .....ssssssceeesseeseeeesseeee vfork(2) 


virtual memory tuning parameters. .vmo_ctl(2SEQ) 
Virtual OUtpUt......ccsessseceseeeeeseeeees 
virtually hangup the specified... 
virtual-memory parameters... 
virtual-to-physical mapping devices 
visual display editor based on ex..... 
vm_ct]: examine and change virtual 
vmtune: tune system-wide.. 
volcopy: make literal copy of.. 


vprintf, vfprintf, vsprintf: print. 
vsig: synchronize a co-process with. 
vsprintf: print formatted output of.. 
VTOC of a block device... 
VTOC of a standalone disk device . 
VTOC on diskS......1.0+eee0 
VTOC partitioning driver. 
ytoc: VTOC partitioning driver... 
WAit At DATTICL....scssseseesersereeatones 
wait: await completion of process 
wait for a child process to stop or terminate. 
wait for a signal. 
wait, waitpid: wait for a chi 
waitpid: wait for a child process to... 
walk @ file tree..tsecsessscseeeeseeeeees 
wall: write to all users. 
WC: WOT COUN. sesesererseees 
wd: SSM SCSI disk controller. 
what: identify SCCS files.. 
whatis: describe what a command is... 
who is doing what...... 
who is on the system 
who: who is on the system.. 
whodo: who is doing what... 
wide virtual-memory parameters 
window option to a menu.. 
WOT COUNL .ssssseeeseere 
word from a stream. 
word on a stream... 


working directory. 
working directory .. 
working directory... 
working directory nam 
working indicator......... 
wp: SSM parallel line printer. 
write file pointer ........ssssesee 
write interface STREAMS module. 
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write: 
putpwent: 
putspent: 
wall: 
write: 
writev: 


open: open for reading or 
utmp, wtmp: utmp and 
utmp, 

accounting records fwtmp, 
and execute command 
multiplexor driver 

tape interface 

xt: 

XS: 

bessel: jO, j1, jn, 

bessel: jO, jl, jn, yO, 


compress, uncompress, 


for dual-channel disk controller 
getzdinfo, getzdinfobyname: get 
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write password file entry 
write shadow password file entry. 
write to all users... 
write to another user. 
write vector on a file.. 
write: write on a file. 
write: write to another user.. 
writev: write vector on a file... 
WYItIN oe. ececsssseeeeee 
wtmp entry formats.. 
wtmp: utmp and wtmp entry formats 
wtmpfix: manipulate conncct........ 
xargs: construct argument list(s).. 
xs: Xylogics 781 terminal 
xt: Xylogics 472 MULITBUS magnetic. 


putspent(3X) 


-write(2) 
.write(1) 
.. writev(2SEQ) 
..open(2) 
-utmp(4) 
-utmp(4) 
fwtmp(1M) 
...xargs(1) 


Xylogics 781 terminal multiplexor driver.. 
y0, y1, yn: Bessel functions.. 
yl, yn: Bessel functions... 
yacc: yet another compiler-compiler 
zcat: compress and expand data... 


zd: dual-channel disk controller...s-sessssssersesecseeseesees 2d(7) 
zdformat: standalone disk formatter.. zdformat(8) 
zdinfo structure... ..getzdinfo(3SEQ) 
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NAME 


INTRO(3) 


intro — introduction to functions and libraries 


DESCRIPTION 
This section describes functions found in various libraries, other than those 
functions that directly invoke operating system primitives, which are 
described in Section 2. Major collections are identified by a letter after the 
section number: 


(8C) 


(3M) 


(3N) 


These functions, together with those of Section 2 and those marked 
(8S), constitute the Standard C Library libc, which is automatically 
loaded by the C compiler, ee(1). The link editor Id(1) searches this 
library under the -Ie option. Declarations for some of these functions 
may be obtained from #include files indicated on the appropriate pages. 


These functions constitute the Math Library, libm. They are automati- 
cally loaded as needed by the FORTRAN compiler. They are not auto- 
matically loaded by the C compiler, ec(1); however, the link editor 
searches this library under the -lm option. Declarations for these func- 
tions may be obtained from the #include file <math.h>. Several gener- 
ally useful mathematical constants are also defined there (see math(5)). 


This contains sets of functions constituting the Network Services 
library. These sets provide protocol independent interfaces to network- 
ing services based on the service definitions of the OSI (Open Systems 
Interconnection) reference model. Application developers access the 
function sets that provide services at a particular level. 


The function set contained in the library is: 


TRANSPORT INTERFACE (TI) - provide the services of the OSI 
Transport Layer. These services provide reliable end-to-end data 
transmission using the services of an underlying network. Applica- 
tions written using the TI functions are independent of the under- 
lying protocols. Declarations for these functions may be obtained 
from the #include file <tiuser.h>. The link editor ld(1) searches 
this library under the -Insl_s option. 


(3PPS) 


The Sequent Parallel Programming Library. These routines take 
advantage of the parallel-processing capabilities of Sequent computers. 
Refer to intro(3pps) for more information about the Parallel Program- 
ming Library routines. 


(3S) These functions constitute the standard I/O package (see stdio(3S)). 
These functions are in the library libe, already mentioned. Declara- 
tions for these functions may be obtained from the #include file 
<stdio.h>. 

(3SEQ) 
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These are Sequent-specific I/O functions in libe. Declarations for these 
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functions may be obtained from the #include file <stdio.h>. 


(8X) Various specialized libraries. The files in which these libraries are 
found are given on the appropriate pages. 


DEFINITIONS 
character 


null character 


character array 


Any bit pattern able to fit into a byte on the machine. 


Acharacter with value 0, represented in the C language 
as’\0’. 
A sequence of characters. 


null-terminated character array 


string 
null string 
NULL 


NULL 


generic function 


netbuf 


buf 


len 


maxlen 


A sequence of characters, the last of which is the null 
character. 


A designation for a null-terminated character array. 
Acharacter array containing only the null character. 


pointer The value that is obtained by casting 0 into a 
pointer. The C language guarantees that this value will 
not match that of any legitimate pointer, so many func- 
tions that return pointers return it to indicate an error. 


Defined as 0 in <stdio.h>; the user can include an 
appropriate definition if not using <stdio.h>. 


Many groups of FORTRAN intrinsic functions have gen- 
eric function names that do not require explicit or 
implicit type declaration. The type of the function is 
determined by the type of its argument(s). For example, 
the generic function max returns an integer value if 
given integer arguments (max0), a real value if given 
real arguments (amax1), or a double-precision value if 
given double-precision arguments (dmax]). 


In the Network Services library, netbuf is a structure 
used in various Transport Interface (TI) functions to 
send and receive data and information. It contains the 
following members: 


unsigned int maxlen; 
unsigned int len; 
char *buf; 


Points to a user input and/or output buffer. 


Specifies the number of bytes contained in the buffer. If 
the structure is used for both input and output, the func- 
tion replaces the user value of len on return. 


Significant only when buf is used to receive output from 
the TI function. In this case, it specifies the physical 
size of the buffer, the maximum value of len that can be 
set by the function. If maxlen is not large enough to 
hold the returned information, an TBUFOVFLW error 
generally results. However, certain functions may 
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FILES 


return part of the data and not generate an error. 


/asr/ib 

/usr/lib/libe.a 
/usr/lib/libc_s.a 
/usr/lib/libm.a 
/usr/fib/lib77.a 
/shlib/libe_s 
/shlib/libnsl_s (3N) 
/usr/lib/libnsl_s.a (3N) 


SEE ALSO 


ar(1), ec(1), 1d(1), lint(1), nm(1), intro(2), intro(3PPS), stdio(3S), math(5) 


DIAGNOSTICS 


Functions in the C and Math Libraries (8C and 3M) may return the conven- 
tional values 0 or +HUGE (the largest-magnitude single-precision floating- 
point numbers; HUGE is defined in the <math.h> header file) when the func- 
tion is undefined for the given arguments or when the value is not represent- 
able. In these cases, the external variable errno (see intro(2)) is set to the 
value EDOM or ERANGE. 


WARNINGS 
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Many of the functions in the libraries call and/or refer to other functions and 
external variables described in this section and in Section 2, System Calls. If 
a program inadvertently defines a function or external variable with the same 
name, the presumed library version of the function or external variable may 
not be loaded. The lint(1) program checker reports name conflicts of this kind 
as “multiple declarations” of the names in question. Definitions for Sections 2, 
3C, and 8S are checked automatically. Other definitions can be included by 
using the -] option. (For example, —lm includes definitions for Section 3M, 
Mathematical Library.) Use of lint is highly recommended. 
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NAME 
a64l, 164a — convert between long integer and base-64 ASCII string 


SYNOPSIS 
long a64l (s) 
char *5; 
char *164a (1) 
long |; 
DESCRIPTION 
These functions are used to maintain numbers stored in base-64 ASCII charac- 
ters. This is a notation by which long integers can be represented by up to six 
characters; each character represents a digit in a radix-64 notation. 


The characters used to represent digits are . for 0, / for 1, 0 through 9 for 2-11, 
A through Z for 12-37, and a through z for 38-63. 
a64l takes a pointer to a null-terminated base-64 representation and returns 
a corresponding long value. If the string pointed to by s contains more than 
six characters, a64l uses the first six. 
a64]l scans the character string from left to right, decoding each character as a 
6 bit Radix 64 number. 
164a takes a long argument and returns a pointer to the corresponding 
base-64 representation. If the argument is 0, 164a returns a pointer to a null 
string. 

WARNINGS 
The value returned by 164a is a pointer into a static buffer, the contents of 
which are overwritten by each call. 
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NAME 
abort — generate an JOT fault 


SYNOPSIS 
int abort ( ) 

DESCRIPTION 
abort does the work of exit(2), but instead of just exiting, abort causes 
SIGABRT to be sent to the calling process. If SIGABRT is neither caught nor 
ignored, all stdio(3S) streams are flushed prior to the signal being sent, and a 
core dump results. 


abort returns the value of the kill(2) system call. 
SEE ALSO 
sdb(1), exit(2), kill(2), signal(2) 


DIAGNOSTICS 
If SIGABRT is neither caught nor ignored, and the current directory is writ- 
able, a core dump is produced and the message abort ~ core dumpedis 
written by the shell. 
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NAME 
abs — return integer absolute value 
SYNOPSIS 
int abs (i) 
int i; 
DESCRIPTION 
abs returns the absolute value of its integer operand. 
SEE ALSO 
floor(3M) 
WARNINGS 
In two’s-complement representation, the absolute value of the negative inte- 
ger with largest magnitude is undefined. This error is not trapped and is 
ignored. 
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NAME 
bsearch — binary search a sorted table 


SYNOPSIS 
#include <search.h> 


char *bsearch (key, base, nel, sizeof (+key), compar) 
char +key; 

char *base; 

unsigned nel; 

int (*compar)( ); 


DESCRIPTION 
bsearch is a binary search routine generalized from Knuth (6.2.1) Algorithm 
B. It returns a pointer into a table indicating where a datum may be found. 
The table must be previously sorted in increasing order according to a pro- 
vided comparison function. key points to a datum instance to be sought in 
the table. base points to the element at the base of the table. nel is the num- 
ber of elements in the table. compar is the name of the comparison function, 
which is called with two arguments that point to the elements being com- 
pared. The function must return an integer less than, equal to, or greater 
than zero as accordingly the first argument is to be considered less than, equal 
to, or greater than the second. 


EXAMPLES 
The example below searches a table containing pointers to nodes consisting of 
a string and its length. The table is ordered alphabetically on the string in 
the node pointed to by each entry. 
This code fragment reads in strings and either finds the corresponding node 
and prints out the string and its length, or prints an error message. 


#include <stdio.h> 
#include <search.h> 


#define TABSIZE 1000 


struct node { /* these are stored in the table */ 
char *string; 
int length; 

ye 

struct node table[TABSIZE]; /* table to be searched */ 


struct node *node_ptr, node; 
int node_compare( ); /* routine to compare 2 nodes */ 
char str_space[20]; /* space to read string into */ 


© node.string = str_space; 


while (scanf("%s", node.string) != EOF) { 
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node ptr = (struct node *)bsearch((char *) (&node), 
(char *)table, TABSIZE, © 
sizeof(struct node), node_compare); 
if (node_ptr != NULL) { 
(void) printf("string = %20s, length = %d\n", 
node_ptr->string, node_ptr->length) ; 
} else { 
(void) printf("not found: %s\n", node.string); 


} 


/* 
This routine compares two nodes based on an 
alphabetical ordering of the string field. 

*/ 

int 

node_compare(nodel, node2) 

char *nodel, *node2; 

{ 
return (stremp( 

((struct node *)nodel)->string, 
((struct node *)node2)->string)); 
} 


NOTES 
The pointers to the key and the element at the base of the table should be of oe) 
type pointer-to-element, and cast to type pointer-to-character. 


The comparison function need not compare every byte, so arbitrary data may 
be contained in the elements in addition to the values being compared. 


Although bsearch is declared as type pointer-to-character, the value 
returned should be cast into type pointer-to-element. 


SEE ALSO 
hsearch(3C), Ilsearch(3C), qsort(3C), tsearch(3C) 


DIAGNOSTICS 
ANULL pointer is returned if the key cannot be found in the table. 
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NAME 
clock — report CPU time used 


SYNOPSIS 
long clock ( ) 


DESCRIPTION 
clock returns the amount of CPU time (in microseconds) used since the first 
call to clock. The time reported is the sum of the user and system times of 
the calling process and its terminated child processes for which it has exe- 
cuted wait(2), pclose(3S), or system(3S). 


The resolution of the clock is 10 milliseconds. 
SEE ALSO 
times(2), wait(2), popen(3S), system(3S) 


BUGS 
The value returned by clock is defined in microseconds for compatibility with 
systems that have CPU clocks with much higher resolution. Because of this, 
the value returned wraps around after accumulating only 2147 seconds of 
CPU time (about 36 minutes). 
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NAME 
@ conv: toupper, tolower, _toupper, _tolower, toascii — translate characters 
SYNOPSIS 


#include <ctype.h> 
int toupper (c) 
int c; 

int tolower (c) 
int ¢; 

int _toupper (c) 
int c; 

int _tolower (c) 
int ¢; 

int toascii (c) 
int c; 


DESCRIPTION 


toupper and tolower have as domain the range of gete(3S)- the integers 
from —1 through 255. Ifthe argument of toupper represents a lowercase 
letter, the result is the corresponding uppercase letter. If the argument of 
tolower represents an uppercase letter, the result is the corresponding lower- 
case letter. All other arguments in the domain are returned unchanged. 


The macros _toupper and _tolower, are macros that accomplish the same 
thing as toupper and tolower but have restricted domains and are faster. 
_toupper requires a lowercase letter as its argument; its result is the corre- 
sponding uppercase letter. The macro _tolower requires an uppercase letter 
as its argument; its result is the corresponding lowercase letter. Arguments 
outside the domain cause undefined results. 


toascii yields its argument with all bits turned off that are not part of a stan- 
dard ASCII character; it is intended for compatibility with other systems. 


SEE ALSO 
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ctype(3C), gete(3S) 
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NAME 
crypt, setkey, encrypt — generate hashing encryption 


SYNOPSIS 
char *crypt (key, salt) 
char +key, *salt; 


void setkey (key) 
char *key; 


void encrypt (block, ignored) 
char «block; 
int ignored; 

DESCRIPTION 
crypt is the password encryption function. It is based on a one way hashing 
encryption algorithm with variations intended (among other things) to frus- 
trate use of hardware implementations of a key search. 


key is a user’s typed password. salt is a two-character string chosen from the 
set [a-zA-Z0-9.]; this string is used to perturb the hashing algorithm in one of 
4096 different ways, after which the password is used as the key to encrypt 
repeatedly a constant string. The returned value points to the encrypted pass- 
word. The first two characters are the salt itself. 


The setkey and encrypt entries provide (rather primitive) access to the 
actual hashing algorithm. The argument of setkey is a character array of 
length 64 containing only the characters with numerical value 0 and 1. If this 
string is divided into groups of 8, the low-order bit in each group is ignored; 
this gives a 56-bit key which is set into the machine. This is the key that will 
be used with the hashing algorithm to encrypt the string block with the func- 
tion encrypt. 


The argument to the encrypt entry is a character array of length 64 contain- 
ing only the characters with numerical value 0 and 1. The argument array is 
modified in place to a similar array representing the bits of the argument 
after having been subjected to the hashing algorithm using the key set by set- 
key. ignored is unused by encrypt but it must be present. 


SEE ALSO 
login(1), passwd(1), getpass(3C), passwd(4) 


WARNINGS 
The return value points to static data that are overwritten by each call. 
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NAME 
& ctime, localtime, gmtime, asctime, cftime, ascftime, mktime, tzset — convert 

date and time to string 

SYNOPSIS 
#include <sys/types.h> 
#include <time.h> 
char *ctime (clock) 
time_t *clock; 
struct tm *localtime (clock) 
time_t *clock; 
struct tm +gmtime (clock) 
time_t +clock; 
char *asctime (tm) 
struct tm *tm; 
int cftime(buf, fmt, clock) 
char *buf, *fmt; 
time_t *clock; 
int ascftime (buf, fmt, tm) 
char *buf, +fmt; 
struct tm *tm; 


time_t mktime (tm) 
@ struct tm *tm; 
extern long timezone, altzone; 
extern int daylight; 
extern char +tzname[2]; 


void tzset ( ) 


DESCRIPTION 
ctime, localtime, and gmtime accept arguments of type time_t (declared in 
<sys/types.h>), pointed to by clock, representing the time in seconds since 
00:00:00 UTC (Universal Time Code, formerly Greenwich Mean Time), Janu- 
ary 1,1970. ctime returns a pointer to a 26-character string in the following 
form. All the fields have constant width: 


Fri Sep 13 00:00:00 1986\n\0 


localtime and gmtime return pointers to tm structures, described below. 
localtime corrects for the main time zone and possible alternate (“Daylight 
Savings”) time zone; gmtime converts directly to UTC, which is the time the 
operating system uses. 

asctime converts a tm structure to a 26-character string, as shown in the 
above example, and returns a pointer to the string. 


Declarations of all the functions and externals, and the tm structure, are in 


@ the <time.h> header file. The structure declaration is: 
structtm { 
int tm_sec; /* seconds after the minute — [0, 59]*/ 
int tm_min; /* minutes after the hour — [0, 59]*/ 
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int tm_hour; /* hour since midnight — [0, 23]*/ 
int tm_mday; /* day of the month — [1, 31]*/ 

int tm_mon; /* months since January ~— [0, 11]*/ 
int tm_year; /* years since 1900*/ 

int tm_wday; /* days since Sunday — [0, 6]*/ 

int tm_yday; /* days since January 1 — [0, 365]*/ 
int tm_isdst; /* flag for daylight savings time*/ 


Me 
tm_isdst is non-zero if the alternate time zone is in effect. 


cftime and ascftime provide the capabilities of ctime and asctime, respec- 
tively, as well as additional ones. eftime takes an integer of type time_t 
pointed to by clock and converts it to a character string. ascftime takes a 
pointer to a tm structure and converts it to a character string. In both func- 
tions, the characters are placed into the array pointed to by buf (plus a ter- 
minating NULL character) and the value returned,is the number of such char- 
acters (not counting the terminating NULL character). fmt controls the for- 
mat of the resulting string. 


fmt is a character string that consists of field descriptors and text characters, 
like the C language printf statement. Each field descriptor consists of a % 
character followed by another character which specifies the replacement for 
the field descriptor. All other characters are copied from fmt into the result. 
The following field descriptors are supported: 


We same as % 

%a abbreviated weekday name 

%A full weekday name 

%b abbreviated month name 

%B full month name 

%d day of month ( 01-31) 

%D date as %m/%d/%y 

Toe day of month (1-31; single digits are preceded by a blank) 
%h. abbreviated month name 

%H hour ( 00 - 23 ) 

1 hour (00 - 12) 

%j day number of year ( 001 - 366 ) 

%m. month number ( 01 - 12 ) 

%M. minute (00 - 59 ) 

%n. same as \n 

%p ante meridian or post meridian 

Yor time as %1:%M:%S Yop 

%R time as %H:%M 

%S seconds ( 00 - 59 ) 

Tot insert a tab 

%T time as %H:%M:%S 

%U week number of year ( 01 - 52 ), Sunday is the first day of week 
Tow weekday number ( Sunday = 0 ) 

7W week number of year (01 - 52 ), Monday is the first day of week 
%x Local specific date format 

%X Local specific time format 
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Ny year within century ( 00 - 99 ) 
YX year as ccyy ( e.g. 1986) 
%L time zone name 


The difference between %U and %W lies in which day is counted as the first of 
the week. Week number 01 is the first week with four or more January days 
in it. 

The example below shows what the values in the tm structure would look like 
for Thursday, August 28, 1986 at 12:44:36 in New Jersey. 


ascftime (buf, "tA %m %d %j", tm) 


This example would result in the buffer containing "Thursday Aug 28 
240". 


If fmt is (char*)0, the value of the environment variable CFTIME is used. If 
CFTIME is undefined or empty, a default format is used. The default format 
string is taken from the file that contains the date and time strings associated 
with the then current language [see below for details on changing the current 
language and cftime(4) for a description of the structure of these files]. 


The user can request that the output of cftime and ascftime be in a specific 
language by setting the environment variable LANGUAGE to the desired lan- 
guage. If LANGUAGE is empty, unset or set to an unsupported language, the 
last language requested is used (the default is the usa-english strings). 


mktime converts the broken-down time (expressed as local time in the struc- 
ture pointed to by *tm), into a calendar time value with the same encoding as 
that of the values returned by the time function. The original values of the 
tm_wday and tm_yday components of the structure are ignored, and the 
original values of the other components are not restricted to the ranges indi- 
cated above. Thus, a positive value for tm_isdat causes mktime to presume 
that Daylight Savings Time is in effect, and a zero value for tm_isdat causes 
mktime to presume that Daylight Savings Time is not in effect. A negative 
value for tm_isdat causes mktime to attempt to determine if Daylight Sav- 
ings Time is in effect for the specified time. On successful completion, the val- 
ues of the tm_wday and tm_yday components of the structure are set appro- 
priately, and the other components are set to represent the calendar time, but 
with their values forced to the ranges indicated above. mktime returns the 
converted calendar time in seconds since 00:00:00 UTC, January 1, 1970, 
encoded as a value of type time_t. If the calendar time cannot be represented, 
mktime returns the value -1 (time_t). The following mktime example 
answers the question, "What day of the week is July 4, 20012": 


#include <stdio.h> 
#include <time.h> 
static cont char *const wday[] = { 
"Sunday", "Monday", "Tuesday", "Wednesday", 
"Thursday", "Friday", "Saturday", "Sunday", "-unknown-" 
Me 
struct tm time_str; 


time_str.tm_year = 2001-1900; 
time_str.tm_mon =7 - 13 
time_str.tm_mday = 4; 


CTIME(3C) DYNIX/ptx 


time_str.tm_hour = 0; 
time_str.tm_min = 0; 
time_str.tm_sec = 1; 
time_str.tm_isdst = -1; 


if (mktime (stime_str) == -1) 

time_str.tm_wday = 7; 
printf ("%s0, wday [time_str.tm_wday]); 
The external long variable timezone contains the difference, in seconds, 
between UTC and the main time zone; the external long variable altzone 
contains the difference, in seconds, between UTC and the alternate time zone; 
both, timezone and altzone default to 0 (UTC). The external variable day- 
light is non-zero if an alternate time zone exists. The time zone names are 
contained in the external variable tzname, which by default is set to 


char *tzname[2] = { "UTC", " Les i 


The functions know about the peculiarities of this conversion for various time 
periods for the U.S.A (specifically, the years 1974, 1975, and 1987). The func- 
tions handle the new daylight savings time starting with the first Sunday in 
April, 1987. 

tzset uses the contents of the environment variable TZ to override the value 
of the different external variables. The syntax of TZ can be described as fol- 


lows: 
TZ > = zone 

| zone signed_time 

| zone signed_time zone 

| zone signed_time zone dst 
zone — letter letter letter 
signed_time — sign time 

| time 
time —> hour 


| hour : minute 
| hour : minute : second 
dst > signed_time 
| signed_time ; dst_date , dst_date 
| ; dst_date , dst_date 


dst_date > date/time 
date —  Jjulianone 

| julianzero 

| Mmonth.week.day 
month > 1121.12 
week > 1121381415 
day > O111213141516 
letter ~*~ GiA(bIBI.. wel2 
hour > 001011...123 : 
minute => 001011..159 
second > o001011..159 
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julianzero > O111..1 365 
julianone > 1121..1366 
sign > -l+ 


tzset scans the contents of the environment variable and assigns the different 
fields to the respective variable. For example, the setting for New Jersey in 
1986 could be 


"ESTSEDT4;117/2:00:00,299/2:00:00" 

or simply 
ESTSEDT 

Asouthern hemisphere setting such as the Cook Islands could be 
"KDT9:30KST10:00; 64/5:00,303/20:00" 


When the longer format is used, the variable must be surrounded by double 
quotes as shown. For more details, see timezone(4) and environ(5). In the 
longer version of the New Jersey example of TZ, tzname[0]is EST, timezone 
is set to 5*60*60, tzname[l]is EDT, altzone is set to 4*60*60, the starting 
date of the alternate time zone is the 117th day at 2 AM, the ending date of 
the alternate time zone is the 299th day at 2 AM, and daylight is set to non- 
zero. Starting and ending times are relative to the alternate time zone. Ifthe 
alternate time zone start and end dates and the time are not provided, the 
days for the United States that year are used and the time is 2 AM. Ifthe 
start and end dates are provided but the time is not provided, the time is mid- 
night. The effects of tzset are thus to change the values of the external vari- 
ables timezone, altzone, daylight and tzname. tzset is called by local- 
time and may also be called explicitly by the user. 


Note that in most installations, TZ is set to the correct value by default when 
the user logs on, via the local /etc/profile file [see profile(4)]. 


Nib/cftime — directory that contains the language specific printable files 


SEE ALSO 


time(2), strftime(3C), getenv(3C), putenv(3C), printf(3S), cftime(4), profile(4), 
timezone(4), environ(5) 


WARNINGS 
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The return values for ctime, localtime and gmtime point to static data 
whose content is overwritten by each call. 


Setting the time during the interval of change from timezone to altzone or 
vice versa can produce unpredictable results. 


The system administrator must change the Julian start and end days annu- 
ally if the full form of the TZ variable is specified. 
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isdigit, isxdigit, islower, isupper, isalpha, isalnum, isspace, iscntrl, ispunct, 
isprint, isgraph, isascii, tolower, toupper, toascci, _tolower, _toupper, 
setchrclass — character handling 


SYNOPSIS 
#include <ctype.h> 


int isdigit (c); 


int c; 


tolower(c) 


int c; 


int setchrelass (chrclass) 
char *chrclass; 


DESCRIPTION 
The character classification macros listed below return non-zero for true, zero 
for false. isascii is defined on all integer values; the rest are defined on valid 
members of the character set and on the single value EOF [see stdio(3S)] 
(guaranteed not to be a character set member). 


isdigit 
isxdigit 


islower 
isupper 
isalpha 


isalnum 


isspace 


iscntrl 


ispunct 


isprint 


isgraph 


isascii 


tests for the digits 0 through 9. 


tests for any character for which isdigit is true or for the 
letters a through for A through F. 


tests for any lowercase letter as defined by the character set. 
tests for any uppercase letter as defined by the character set. 


tests for any character for which islower or isupper is true 
and possibly any others as defined by the character set. 


tests for any character for which isalpha or isdigit is true. 


tests for a space, horizontal-tab, carriage return, newline, ver- 
tical-tab, or form-feed. 

tests for “control characters” as defined by the character set. 
tests for any character other than the ones for which isal- 
num, isentrl, or isspace is true or space. 


tests for a space or any character for which isalnum or 
ispunct is true or other “printing character” as defined by 
the character set. 


tests for any character for which isprint is true, except for 
space. 


tests for an ASCII character (a non-negative number less than 
0200.) 


The conversion functions and macros translate a character from lowercase 
(uppercase) to uppercase (lowercase). 
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tolower if the character is one for which isupper is true and there a 
corresponding lowercase character, tolower returns the cor- 
responding lowercase character. Otherwise, the character is 
returned unchanged. 


toupper if the character is one for which islower is true and there isa 
corresponding uppercase character, toupper returns the cor- 
responding uppercase character. Otherwise, the character is 
returned unchanged. 


toascii turns off the bits that are not part of the ASCII character set. 


_tolower returns the lowercase representation of a character for which 
isupper is true, otherwise undefined. 


_toupper returns the uppercase representation of a character for which 
islower is true, otherwise undefined. 


toupper and tolower have as domain the range of getc(3S)- the integers 
from —1 through 255. All other arguments in the domain are returned 
unchanged. The conversion macros have the same functionality of the func- 
tions on valid input, but the macros are faster because they do not do range 
checking. 


All the character classification macros and the conversion functions and mac- 
ros do a table lookup. 


setchrelass initializes the table used by these functions and macros to a spe- 
cific character classification set. setchrelass uses the value of its argument 
or the value of the environment variable CHRCLASS as the name of the 
datafile containing the information for the desired character set. These 
datafiles are searched for in the special directory /lib/chrclass. 


If chrelass is (char*)0, the value of the environment variable CHRCLASS is 
used. If CHRCLASS is not set or is undefined, the table retains its current 
value, which at initialization time is ASCIL. 


FILES 

Nlib/chrelass — directory containing the datafiles for setchrelass 
SEE ALSO 

chrtbl(1), stdio(3S), ascii(5), environ(5) 
DIAGNOSTICS 


If the argument to any of the character handling macros is not in the domain 
of the function, the result is undefined. 


If setchrclass does not successfully fill the table, the table will not change 
(initially ASCID) and -1 is returned. If successful, setchrclass returns 0. 
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NAME 


dev_to_ttyname, ttyname_to_dev — convert between major/minor numbers 
and tty names 


SYNOPSIS 


char *dev_to_ttyname(dev) 
dev_t dev; 


int ttyname_to_dev(name, dev) 
char *name; 
dev_t *dev; 


DESCRIPTION 


These functions do conversions between device major and minor numbers and 
tty pathnames. The path is guaranteed to be unique for major numbers 
between 0 and 1023 inclusive (10 bits) and minor numbers between 0 and 
16383 inclusive (14 bits), or 16,777,216 entries. There is a one-to-one mapping 
between devices and their names. 


dev_to_ttyname returns a pointer toa NULL-terminated string of the form 
/dev /tty<subdir> /<basename>, where basename is a unique four character 
string and subdir is two characters. The first and third characters of 
basename determine the directory name for subdir. For example, in 
/dev/ttyac/abcd), the first character, a, and the third character, c, are 
appended to tty to determine the subdir directory name ttyac. Using the first 
and third symbols from basename causes minor numbers to rotate between 4 
directories every 64 entries. No other major numbers use those 4 directories. 


Not counting the string /dev/, the resulting 10 character path names are 
suitable for use in utmp ut_line field. The unique 4 character basename can 
be used in the utmp ut_id field. The entire path can be constructed from the 
unique basename. 


ttyname_to_dev takes any potiential path to a tty device, extracts the 
basename and calculates the associated device. The device is then returned in 
dev. 


To arrive at the subdir_-basename combination, the lower 10 bits of the major 
number and lower 14 bits of the minor number are converted into four 6 bit 
quantities. Each 6 bit value is converted into a unique 4 character name 
using base 64 arithmetic. 

Base 64 digits are arbitrarily represented by the symbols (A-Za-z0-9_+] where 
A? == 0,’a’ == 26, 0’ == 52, underscore (_) == 62, and plus sign (+) == 68. The 
number AAAA has the value 0 and AAA+ has the value 63. 


DIAGNOSTICS ~ 
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Upon successful completion, ttyname_to_dev returns 0. If the basename of 
the input string is greater than four non-NULL characters or the basename 
contains symbols not found in the regular expression [A-Za-z0-9_+], a value of 
-1 is returned. 

There is no error condition for dev_to_ttyname. It silently truncates dev to 
10 bits of major and 14 bits of minor. 
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EXAMPLES 
The following table gives an example of the directory names used for certain 
major numbers: 


minor ranges 


major number directory 0 to 255 256 to 511 
0 ttyAA AAAAtoAAA+ ABAA to ABA+ 
ttyAB AABA to AAB+ ABBA to ABB+ 
ttyAC AACA to AAC+ ABCA to ABC+ 
ttyAD AADA to AAD+ ABDAto ABD+ 
6 ttyGA GAAA to GAA+ GBAA to GBAt+ 
ttyGB GABA to GAB+ GBBAto GBB+ 
ttyGC GACA toGAC+ GBCAto GBC+ 
ttyGD GADA toGAD+ GBDAto GBD+ 
The tty device names for the 16 lines of a controller with major number 6 are: 
major=6, minor=0 /dev/ttyGA/GAAA 
major=6, minor=1 /devittyGA/GAAB 
major=6, minor=2 /dev/ttyGA/GAAC 
major=6, minor=15 —_/dev/ttyGA/GAAP 


SEE ALSO 
ttyname (3c), ttydevname (1) 

BUGS 
These routines are designed to allow speculation, thus major numbers are not 
checked for validity before conversion. For example, major=0 and major=1024 
return the same path. 
Only the basename of name is checked, so an obviously bad path may still 
return a valid dev. For example, the path /dev/hello/world/ABCD would 
show ABCD as a valid basename. 
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NAME 


dial — establish an out-going terminal line connection 


SYNOPSIS 


include <dial.h> 
int dial (call) 
CALL call; 


void undial (fd) 
int fd; 


DESCRIPTION 
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dial returns a file-descriptor for a terminal line open for read/write. The 
argument to dial is a CALL structure (defined in the <dial.h> header file). 
When finished with the terminal line, the calling program must invoke 
undial to release the semaphore that has been set during the allocation of the 
terminal device. 

The definition of CALL in the <dial.h> header file is: 


typedef struct { 
struct termio *attr;/* pointer to termio attribute struct */ 


int baud; /* transmission data rate */ 

int speed; /* 212A modem: low=300, high=1200 */ 

char *line; /* device name for out-going line */ 

char *telno; /* pointer to tel-no digits string */ 

int modem; /* specify modem control for direct lines */ 


char *device; /* unused */ 
int dev_len; /* unused */ 
} CALL; 


The CALL element speed is intended only for use with an outgoing dialed 
call. The value should match the modem speed setting. The typical values 
are: 110, 300, 600, 1200, 2400, 4800, 9600, and 19200. The CALL element 
baud is for the desired transmission baud rate. For example, one might set 
baud to 110 and speed to 300 (or 1200). However, if speed is set to 1200, 
baud must be set to high (1200). 


Ifthe desired terminal line is a direct line, a string pointer to its device-name 
should be placed in the line element in the CALL structure. Legal values for 
such terminal device names are kept in the Devices file. In this case, the value 
of the baud element should be set to -1. This will cause dial to determine the 
correct value from the Devices file. 


The telno element is for a pointer to a character string representing the tele- 
phone number to be dialed. Such numbers may consist only of these charac- 
ters: 


0-9 dial 0-9 
* dial * 
# dial # 


wait for secondary dail tone 
- delay for approximately 4 seconds 
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This element should be non-zero if modem control is required. The CALL ele- 
ment attr is a pointer to a termio structure, as defined in the <termio.h> 
header file. A NULL value for this pointer element may be passed to the dial 
function, but if such a structure is included, the elements specified in it will be 
set for the outgoing terminal line before the connection is established. This is 
often important for certain attributes such as parity and baud-rate. 


The CALL elements device and dev_len are no longer used. They are 
retained in the CALL structure for compatibility reasons. 


The CALL element modem is used to specify modem control for direct lines. » 


/usr/lib/uucp/Devices 
/usr/lib/uucp/Systems 
/usr/spool/uucp/LCK. tty-device 


SEE ALSO 


uucp(1C), alarm(2), read(2), write(2), termio(7) 


DIAGNOSTICS 


On failure, a negative value indicating the reason for the failure will be 
returned. Mnemonics for these negative indices as listed here are defined in 
the <dial.h> header file. 


INTRPT =i /* interrupt occurred */ 

D_HUNG =e /* dialer hung (no return from write) */ 
NO_ANS -3 /* no answer within 10 seconds */ 

ILL_BD -4 /* illegal baud-rate */ ss) 
A_PROB 5 /* acu problem (open() failure) */ 

L_PROB -6 /* line problem (open() failure) */ 

NO_Ldv =7 /* can't open Devices file */ 

DV_NT_A -8 /* requested device not available */ 
DV_NT_K a, /* requested device not known */ 

NO_BD_A -10 /* no device available at requested baud */ 
NO_BD_K -11 /* no device known at requested baud */ 
DV_NT_E =12 /* requested speed does not match */ 
BAD_SYS -13 /* system not in Systems file*/ 


WARNINGS 


BUGS 


Including the <dial.h> header file automatically includes the <termio.h> 
header file. . 


The above routine uses <stdio.h>, which causes it to increase the size of pro- 
grams, not otherwise using standard I/O, more than might be expected. 


An alarm(2) system call for 3600 seconds is made (and caught) within the 
dial module for the purpose of “touching” the LCK.. file and constitutes the 
device allocation semaphore for the terminal device. Otherwise, uucp(1C) 
may simply delete the 1LCK.. entry on its 90-minute clean-up rounds. The 
alarm may go off while the user program is in a read(2) or write(2) system 
call, causing an apparent error return. If the user program expects to be 
around for an hour or more, error returns from reads should be checked for 
(errno==EINTR), and the read possibly reissued. 
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DYNIX/ptx DRAND48(3C) 


NAME 
& drand48, erand48, lrand48, nrand48, mrand48, jrand48, srand48, seed48, 


lcong48 — generate uniformly distributed pseudorandom numbers 


SYNOPSIS 


double drand48 ( ) 


double erand48 (xsubi) 
unsigned short xsubi[3]; 


long lrand48 ( ) 


long nrand48 (xsubi) 
unsigned short xsubi[3]; 


long mrand48 ( ) 


long jrand48 (xsubi) 
unsigned short xsubi([3]; 


void srand48 (seedval) 
long seedval; 


unsigned short *seed48 (seed16v) 


_unsigned short seed16v[3]; 


void lcong48 (param) 
unsigned short param[7]; 


DESCRIPTION 
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This family of functions generates pseudorandom numbers using the well- 
known linear congruential algorithm and 48-bit integer arithmetic. 


Functions drand48 and erand48 return non-negative double-precision float- 
ing-point values uniformly distributed over the interval [0.0, 1.0}. 


Functions lrand48 and nrand48 return non-negative long integers uniformly 
distributed over the interval [0, 2°). 


Functions mrand48 and jrand48 return signed long integers uniformly dis- 
tributed over the interval [-231,251), 


Functions srand48, seed48 and Icong48 are initialization entry points, one 
of which should be invoked before either drand48, lrand48 or mrand48 is 
called. (Although it is not recommended practice, constant default initializer 
values are supplied automatically if drand48, lrand48 or mrand48 is called 
without a prior call to an initialization entry point.) Functions erand48, 
nrand48 and jrand48 do not require an initialization entry point to be called 
first. 


All the routines work by generating a sequence of 48-bit integer values, .X;, 
according to the linear congruential formula 


Xn+1=(aX;, +C)moamn 20. 
The parameter m = 2** hence 48-bit integer arithmetic is performed. Unless 
lcong48 has been invoked, the multiplier value a and the addend value c are 
given by 

a=5DEECE66D ,g=273673163155 

c=B ie=13 8 
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nrand48, mrand4§8 or jrand48 is computed by first generating the next 
48-bit X; in the sequence. Then the appropriate number of bits, according to 
the type of data item to be returned, are copied from the high-order (leftmost) 
bits of X; and transformed into the returned value. 


The functions drand48, lrand48 and mrand48 store the last 48-bit X; gen- 
erated in an internal buffer, and must be initialized prior to being invoked. 
The functions erand48, nrand48 and jrand48 require the calling program to 
provide storage for the successive X; values in the array specified as an argu- 
ment when the functions are invoked. These routines do not have to be ini- 
tialized; the calling program must place the desired initial value of X; into the 
array and pass it as an argument. By using different arguments, functions 
erand48, nrand48 and jrand48 allow separate modules of a large program 
to generate several independent streams of pseudorandom numbers, i.e., the 
sequence of numbers in each stream will not depend upon how many times the 
routines have been called to generate numbers for the other streams. 


The initializer function srand48 sets the high-order 32 bits of X; its argu- 
ment. The low-order 16 bits of X; are set to the arbitrary value 330Ej.. 


The initializer function seed4& sets the value of X; to the 48-bit value speci- 
fied in the argument array. In addition, the previous value of X; is copied into 
a 48-bit internal buffer, used only by seed48, and a pointer to this buffer is 
the value returned by seed48. This returned pointer, which can just be 
ignored if not needed, is useful if a program is to be restarted from a given 
point at some future time — use the pointer to get at and store the last X; 
value, and then use this value to reinitialize via seed48 when the program is 
restarted. 


The initialization function leong48 allows the user to specify the initial X;, 
the multiplier value a, and the addend value c. Argument array elements 
param[0-2] specify X;, param[3-5] specify the multiplier a, and param[6] 
specifies the 16-bit addendc. After leong48 has been called, a subsequent 
call to either srand48 or seed48 will restore the “standard” multiplier and 
addend values, a and c, specified on the previous page. 


NOTES 
The source code for the portable version can be used on computers which do 
not have floating-point arithmetic. In such a situation, functions drand48 
and erand4§8 are replaced by the two new functions below. 


The value returned by any of the functions drand48, erand48, lrand48, & 


long irand48 (m) 

unsigned short m; 

long krand48 (xsubi, m) 

unsigned short xsubi[3], m; 

Functions irand48 and krand48 return non-negative long integers uniformly 
distributed over the interval [0, m-1 ]. 


SEE ALSO 
rand(3C) 
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DYNIX/ptx ECVT(3C) 


@ NAME 


ecvt, fevt, gevt — convert floating-point number to string 


SYNOPSIS 


char *ecvt (value, ndigit, decpt, sign) 
double value; 

int ndigit, *decpt, *sign; 

char *fcvt (value, ndigit, decpt, sign) 
double value; 

int ndigit, *decpt, *sign; 

char *gevt (value, ndigit, buf) 
double value; 

int ndigit; 

char *buf; 


DESCRIPTION 


ecvt converts value to a NULL-terminated string of ndigit digits and 
returns a pointer thereto. The high-order digit is non-zero, unless the value is 
zero. The low-order digit is rounded. The position of the decimal point rela- 
tive to the beginning of the string is stored indirectly through decpt (negative 
means to the left of the returned digits). The decimal point is not included in 
the returned string. If the sign of the result is negative, the word pointed to 
by sign is non-zero, otherwise it is zero. 


fevt is identical to eevt, except that the correct digit has been rounded for 
printf %f (FORTRAN F-format) output of the number of digits specified by ndi- 
git. 

gevt converts the value to a null-terminated string in the array pointed to by 
buf and returns buf. It attempts to produce ndigit significant digits in FOR- 
TRAN F-format if possible, otherwise E-format, ready for printing. A minus 
sign, if there is one, or a decimal point will be included as part of the returned 
string. Trailing zeros are suppressed. 


SEE ALSO 


BUGS 


printf(3S) 


The values returned by ecvt and fevt point to a single static data array whose 
content is overwritten by each call. The static data array is limited to 80 
characters in length, so any results greater than 80 characters may yield 
unpredictable results. 
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NAME 
end, etext, edata — last locations in program 


SYNOPSIS 
extern end; 
extern etext; 
extern edata; 


DESCRIPTION 
These names refer neither to routines nor to locations with interesting con- 
tents. The address of etext is the first address above the program text, edata 
above the initialized data region, and end above the uninitialized data region. 


When execution begins, the program break (the first location beyond the data) 
coincides with end, but the program break may be reset by the routines of 
brk(2), malloc(3C), standard input/output (stdio(3S)), the profile (-p) option 
of cc(1), and so on. Thus, the current value of the program break should be 
determined by sbrk (char *)(0) (see brk(2)). 


SEE ALSO 
cc(1), brk(2), malloc(3C), stdio(3S) 
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DYNIX/ptx FPGETROUND(3C) 


@ NAME 


fpgetround, fpsetround, fpgetmask, fpsetmask, fpgetsticky, fpsetsticky - IEEE 
floating-point environment control 


SYNOPSIS 


include <ieeefp.h> 
typedef enum { 


FP_RN=0, /* round to nearest */ 
FP_RP, /* round to plus +/ 

FP_RM, /* round to minus */ 

FP_RZ, /* round to zero (truncate) */ 
} fp_rnd; 


fp_rnd fpgetround(); 


fp_rnd fpsetround(rnd_dir) 
fp_rnd rnd_dir; 


define fp_except int 

define FP_X_INV 0x01 /* invalid operation exception*/ 
define FP_X_DNML 0x02 /* denormalization exception*/ 
define FP_X_DZ 0x04 /* divide-by-zero exception*/ 
define FP_X_OFL 0x08 /* overflow exception*/ 

define FP_X_UFL 0x10 /* underflow exception*/ 

define FP_X_IMP 0x20 /* imprecise (loss of precision)+/ 


fp_except fpgetmask(); 


fp_except fpsetmask(mask); 
fp_except mask; 


fp_except fpgetsticky(); 


fp_except fpsetsticky(sticky); 
except sticky; 


DESCRIPTION 
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There are six floating-point exceptions: divide-by-zero, overflow, underflow, 
imprecise (inexact) result, denormalization, and invalid operation. When a 
floating-point exception occurs, the corresponding sticky bit is set (1), and if 
the mask bit is enabled (1), the trap takes place. These routines let the user 
change the behavior on occurrence of any of these exceptions, as well as 
change the rounding mode for floating-point operations. 


fpgetround () returns the current rounding mode. 


fpsetround () sets the rounding mode and returns the previous rounding 
mode. 


fpgetmask () returns the current exception masks. 


fpsetmask () sets the exception masks and returns the previous setting. 
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fpgetsticky () returns the current exception sticky flags. 


fpsetsticky () sets (clears) the exception sticky flags and returns the previous 
setting. 


The default environment is: 


Rounding mode set to nearest(FP_RN), 
Divide-by-zero, 

Floating point overflow, and 

Invalid operation traps enabled. 


SEE ALSO 
isnan(3C) 


WARNINGS 
fpsetsticky () modifies all sticky flags. fpsetmask () changes all mask bits. 


Both C and FORTRAN require truncation (round to zero) for floating-point to 
integral conversions. The current rounding mode has no effect on these con- 
versions. 


One must clear the sticky bit to recover from the trap and to proceed. If the 
sticky bit is not cleared before the next trap occurs, a wrong exception type 
may be signaled. 


For the same reason, when calling fpsetmask() the user should make sure 
that the sticky bit corresponding to the exception being enabled is cleared. 
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DYNIX/ptx FREXP(3C) 


NAME 


frexp, ldexp, modf— manipulate parts of floating-point numbers 


SYNOPSIS 


double frexp (value, eptr) 
double value; 

int *eptr; 

double Idexp (value, exp) 
double value; 

int exp; 

double modf (value, iptr) 
double value, *iptr; 


DESCRIPTION 


Every non-zero number can be written uniquely as x *2 to the nth power 
where the mantissa (fraction) x is in the range 0.5 < | x | < 1.0, and the expo- 
nent nis aninteger. frexp returns the mantissa of a double value, and 
stores the exponent indirectly in the location pointed to by eptr. If value is 
zero, both results returned by frexp are zero. 


ldexp returns the quantity value *2 to the exp power. 


modf returns the signed fractional part of value and stores the integral part 
indirectly in the location pointed to by iptr. 


DIAGNOSTICS ' 
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If ldexp would cause overflow, +HUGE (defined in <math.h> ) is returned 
(according to the sign of value), and errno is set to ERANGE. 


If ldexp would cause underflow, zero is returned and errno is set to 
ERANGE. 
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NAME 


ftw — walk a file tree 


SYNOPSIS 


#include <ftw.h> 

int ftw (path, fn, depth) 
char *path; 

int (*fn) ( ); 

int depth; 


DESCRIPTION 


ftw recursively descends the directory hierarchy rooted in path. For each 
object in the hierarchy, ftw calls fn, passing it a pointer to a null-terminated 
character string containing the name of the object, a pointer to a stat struc- 
ture (see stat(2)) containing information about the object, and an integer. 
Possible values of the integer, defined in the <ftw.h> header file, are FTW_F 
for a file, FTW_D for a directory, FTW_DNR for a directory that cannot be read, 
and FTW_NS for an object for which stat could not successfully be executed. If 
the integer is FTW_DNR, descendants of that directory will not be processed. 
If the integer is FTW_NS, the stat structure will contain garbage. An example 
of an object that would cause FTW_NS to be passed to fn would be a file ina 
directory with read but without execute (search) permission. 


ftw visits a directory before visiting any of its descendants. 


The tree traversal continues until the tree is exhausted, an invocation of fn 
returns a non-zero value, or some error is detected within ftw (such as an I/O 
error). If the tree is exhausted, ftw returns zero. If fn returns a non-zero 
value, ftw stops its tree traversal and returns whatever value was returned 
by fn. If ftw detects an error, it returns —1, and sets the error type in errno. 


ftw uses one file descriptor for each level in the tree. The depth argument 
limits the number of file descriptors so used. If depth is zero or negative, the 
effect is the same as if it were 1. depth must not be greater than the number 
of file descriptors currently available for use. ftw will run more quickly if 
depth is at least as large as the number of levels in the tree. 


SEE ALSO 


BUGS 


stat(2), malloc(3C) 


Because ftw is recursive, it is possible for it to terminate with a memory fault 
when applied to very deep file structures. 


WARNINGS 
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ftw uses malloc(3C) to allocate dynamic storage during its operation. If ftw 
is forcibly terminated, such as by longjmp being executed by fn or an inter- 
rupt routine, ftw will not have a chance to free that storage, so it will remain 
permanently allocated. A safe way to handle interrupts is to store the fact 
that an interrupt has occurred, and arrange to have fn return a non-zero 
value at its next invocation. 
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NAME 
getcwd — get pathname of current working directory 

SYNOPSIS 
char *getewd (buf, size) 
char *buf; 
int size; 

DESCRIPTION 
getewd returns a pointer to the current directory pathname. The value of 
size must be at least two greater than the length of the pathname to be 
returned. 
If buf is a NULL pointer, getewd obtains size bytes of space using mal- 
loc(3C). In this case, the pointer returned by getewd may be used as the 
argument in a subsequent call to free. 


EXAMPLES 
void exit(), perror(); 


if ((cwd = getcwd((char *)NULL, 64)) == NULL) { 
perror ("getcwd") ; 
exit (2); 


} 


printf ("%s\n", cwd); 


SEE ALSO 
malloc(3C) 


DIAGNOSTICS 
Returns NULL with errno set if size is not large enough, or if an error occurs 
in a lower-level function. 
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DYNIX/ptx GETENV(3C) 


NAME 
getenv — return value for environment name 


SYNOPSIS 
char *getenv (name) 
char *name; 


DESCRIPTION 
getenv searches the environment list (see environ(5)) for a string of the form 


name = value 


and returns a pointer to the value in the current environment if such a string 
is present, otherwise a NULL pointer. 


SEE ALSO 
exec(2), putenv(3C), environ(5) 
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DYNIX/ptx GETGRENT(3C) 


NAME 
@ getgrent, getgrgid, getgrnam, setgrent, endgrent, fgetgrent — get group file 

entry 

SYNOPSIS 
#include <grp.h> 
struct group *getgrent ( ) 
struct group *getgrgid (gid) 
gid_t gid; 
struct group *getgrnam (name) 
char «name; 
void setgrent ( ) 
void endgrent ( ) 
struct group *fgetgrent (f) 
FILE *f; 

DESCRIPTION 
getgrent, getgrgid and getgrnam each return pointers to an object with the 


following structure containing the broken-out fields of a line in the /etc/group 
file. Each line contains a “group” structure, defined in the <grp.h> header 


file. 
struct group { 
char *gr_name; /* the name of the group */ 
char *gr_passwd,/* the encrypted group password */ 
gid_t gr_gid; /* the numerical group ID */ 


char **gr_mem; /* vector of pointers to member names *, 

Me 
getgrent when first called returns a pointer to the first group structure in the 
file; thereafter, it returns a pointer to the next group structure in the file; so, 
successive calls may be used to search the entire file. getgrgid searches from 
the beginning of the file until a numerical group id matching gid is found and 
returns a pointer to the particular structure in which it was found. get- 
grnam searches from the beginning of the file until a group name matching 
name is found and returns a pointer to the particular structure in which it 
was found. If an end-of-file or an error is encountered on reading, these func- 
tions return a NULL pointer. 
Acall to setgrent has the effect of rewinding the group file to allow repeated 
searches. endgrent may be called to close the group file when processing is 
complete. 
fgetgrent returns a pointer to the next group structure in the stream f, 
which matches the format of /etc/group. 


FILES 
/ete/group 


SEE ALSO 
getlogin(3C), getpwent(3C), group(4) 


DIAGNOSTICS 
ANULL pointer is returned on EOF or error. 
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WARNINGS 
The above routines use <stdio.h>, which causes them to increase the size of 
programs, not otherwise using standard I/O, more than might be expected. 


All information is contained in a static area, so it must be copied if it is to be 
saved. 
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DYNIX/ptx GETLOGIN(3C) 


NAME 
getlogin — get login name 


SYNOPSIS 
char *getlogin ( ); 

DESCRIPTION 
getlogin returns a pointer to the login name as found in /etc/utmp. It may 
be used in conjunction with getpwnam to locate the correct password file 
entry when the same user ID is shared by several login names. 


If getlogin is called within a process that is not attached to a terminal, it 
returns a NULL pointer. The correct procedure for determining the login 
name is to call cuserid, or to call getlogin and if it fails to call getpwuid. 


FILES 
/etc/utmp 


SEE ALSO 
cuserid(3S), getgrent(3C), getpwent(3C), utmp(4) 


DIAGNOSTICS 
Returns the NULL pointer if name is not found. 


WARNINGS 
The return values point to static data whose content is overwritten by each 


call. 
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DYNIX/ptx GETOPT(3C) 


NAME 


getopt — get option letter from argument vector 


SYNOPSIS 


int getopt (arge, argv, optstring) 
int arge; 

char **argv, *opstring; 

extern char *optarg; 

extern int optind, opterr; 


DESCRIPTION 


getopt returns the next option letter in argv that matches a letter in opt- 
string. It supports all the rules of the command syntax standard (see 
intro(1)). So all new commands will adhere to the command syntax standard, 
they should use getopts(1) or getopt(3C) to parse positional parameters and 
check for options that are legal for that command. 


optstring must contain the option letters the command using getopt will 
recognize; if a letter is followed by a colon, the option is expected to have an 
argument, or group of arguments, which must be separated from it by white 
space. 


optarg is set to point to the start of the option-argument on return from 
getopt. 


getopt places in optind the argv index of the next argument to be processed. 
optind is external and is initialized to 1 before the first call to getopt. 


When all options have been processed (i.e., up to the first non-option argu- 
ment), getopt returns -L_ The special option “—” may be used to delimit the 
end of the options; when it is encountered, —1 will be returned, and “—” will 
be skipped. 


DIAGNOSTICS 


getopt prints an error message on standard error and returns a question 
mark (?) when it encounters an option letter not included in optstring or no 
option-argument after an option that expects one. This error message may be 
disabled by setting opterr to 0. 


EXAMPLES 
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The following code fragment shows how one might process the arguments for a 
command that can take the mutually exclusive options a and b, and the option 
o, which requires an option-argument: 


main (argc, argv) 

int argc; 

char **argv; 

{ 
int ¢; 
extern char *optarg; 
extern int optind; 
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while ((c = getopt(argec, argv, "“abo:")) != -1) 


switch (c) { 
case ‘a’: 
if (bflg) 
errflg++; 
else 
aflg++; 
break; 
case ‘b’; 
if (aflg) 
errflgt++; 
else 
bproc( ); 
break; 
case ‘0’: 
ofile = optarg; 
break; 
case '?’: 
errflgtt; 


if (errflg) { 
(void) fprintf(stderr, "usage: . . . “")? 
exit (2); 

} 

for ( ; optind < argc; optind++) { 
if (access(argv[optind], 4)) { 


) 


WARNINGS 
Although the following command syntax rule (see intro(1)) relaxations are 
permitted under the current implementation, they should not be used because 
they may not be supported in future releases of the system. Asin the 
EXAMPLE section above, a and b are options, and the option o requires an 
option-argument: 
cmd -aboxxx file (Rule 5 violation: options with 
option-arguments must not be grouped with other options) 
cmd -ab -oxxx file (Rule 6 violation: there must be 
white space after an option that takes an option-argument) 
SEE ALSO 
getopts(1), intro(1) 
Changing the value of the variable optind, or calling getopt with different 
values of argv, may lead to unexpected results. 
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DYNIX/ptx GETPASS(3C) 


NAME 
getpass — read a password 


SYNOPSIS 
char *getpass (prompt) 
char *prompt; 

DESCRIPTION 
getpass reads up to a newline or EOF from the file /dev/tty, after prompting 
on the standard error output with the null-terminated string prompt and 
disabling echoing. A pointer is returned to a null-terminated string of at most 
8 characters. If /dev/tty cannot be opened, a NULL pointer is returned. An 
interrupt will terminate input and send an interrupt signal to the calling pro- 
gram before returning. 


FILES 
/devitty 


WARNINGS 
The above routine uses <stdio.h>, which causes it to increase the size of pro- 


grams not otherwise using standard I/O more than might be expected. 


The return value points to static data whose content is overwritten by each 
call. 
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DYNIX/ptx GETPW(3C) 


NAME 
getpw — get name from UID 

SYNOPSIS 
int getpw (uid, buf) 
int uid; 
char *buf; 

DESCRIPTION 
getpw searches the password file for a user ID number that equals uid, 
copies the line of the password file in which uid was found into the array 
pointed to by buf, and returns 0. getpw returns non-zero if uid cannot be 
found. 
This routine is included only for compatibility with prior systems and should 
not be used; see getpwent(3C) for routines to use instead. 

FILES 
/etc/passwd 

SEE ALSO 
getpwent(3C), passwd(4) 

DIAGNOSTICS 
getpw returns non-zero on error. 

WARNINGS 
The above routine uses <stdio.h> which causes it to increase, more than 
might be expected, the size of programs not otherwise using standard YO. 
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NAME 


getpwent, getpwuid, getpwnam, setpwent, endpwent, fgetpwent — get pass- 
word file entry 


SYNOPSIS 


#include <pwd.h> 
struct passwd *getpwent ( ) 


struct passwd *getpwuid (uid) 
uid_t uid; 


struct passwd *getpwnam (name) 
char «name; 


void setpwent ( ) 
void endpwent ( ) 


struct passwd *fgetpwent (f) 
FILE *f; 


DESCRIPTION 
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getpwent, getpwuid and getpwnam each returns a pointer to an object 
with the following structure containing the broken-out fields of a line in the 
/etc/passwd file. Each line in the file contains a “passwd” structure, declared 
in the <pwd.h> header file: 


struct passwd { 
char *pw_name; 
char *pw_passwd; 
uid_t pw_uid; 
gid_t pw_gid; 
char *pw_age; 
char *pw_comment; 
char *pw_gecos; 
char *pw_dir; 
char *pw_shell; 
Me 
This structure is declared in <pwd.h> so it is not necessary to redeclare it. 
The fields have meanings described in passwd(4). 


getpwent when first called returns a pointer to the first passwd structure in 
the file; thereafter, it returns a pointer to the next passwd structure in the 
file; so successive calls can be used to search the entire file. getpwuid 
searches from the beginning of the file until a numerical user id matching uid 
is found and returns a pointer to the particular structure in which it was 
found. getpwnam searches from the beginning of the file until a login name 
matching name is found, and returns a pointer to the particular structure in 
which it was found. If an end-of-file or an error is encountered on reading, 
these functions return a NULL pointer. 


Acall to setpwent has the effect of rewinding the password file to allow 
repeated searches. endpwent may be called to close the password file when 
processing is complete. 
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fgetpwent returns a pointer to the next passwd structure in the stream f, 
which matches the format of /etc/passwd. 


FILES 
/etc/passwd 


SEE ALSO 

mkpwdbm(1), getlogin(3C), getgrent(3C), passwd(4) 
DIAGNOSTICS 

ANULL pointer is returned on EOF or error. 


WARNINGS 
The above routines use <stdio.h> which causes them to increase the size of 
programs, not otherwise using standard I/O, more than might be expected. 
All information is contained in a static area, so it must be copied if it is to be 
saved. 
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NAME 


GETUT(3C) 


getut: getutent, getutid, getutline, pututline, setutent, endutent, utmpname, 


getutpid — access utmp file entry 


SYNOPSIS 


#include <utmp.h> 
struct utmp *getutent ( ) 


struct utmp *getutid (id) 
struct utmp *id; 


struct utmp *getutline Gine) 
struct utmp *line; 


void pututline (utmp) 
struct utmp *utmp; 


void setutent ( ) 

void endutent ( ) 

void utmpname (file) 

char *file; 

Sequent extensions: 

struct utmp *getutpid (pid) 
struct utmp *pid; 

char *ut_find_host(line) 
char *line; 

in ut_get_entry(ut_entry, ut_host) 
struct utmp **ut_entry 
char **ut_host 


DESCRIPTION 
getutent, getutid , getutline and getutpid each return a pointer to a struc- 


12/89 


ture of the following type: 


struct utmp { 


char ut_user[8); 

char ut_id[4]; 

char ut_line[12]; 

short ut_pid; 

short ut_type; 

struct exit_status { 
short e_ termination; 
short e_exit; 

} ut_exit; 

time_t ut_time; 


Me 


User login name */ 

/etc/inittab ID (usually line #)*/ 
device name (console, 1lnxx) */ 
process ID */ 

type of entry */ 


Process termination status */ 
Process exit status */ 

The exit status of a process 
marked as DEAD_PROCESS. */ 
time entry was made */ 


getutent reads in the next entry from a utmp-like file. If the file is not 
already open, it opens it. If it reaches the end of the file, it fails. 


getutid searches the utmp file until it finds an entry with a ut_type match- 
ing id->ut_type if the type specified is RUN_LVL, BOOT_TIME, OLD_TIME or 
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USER_PROCESS or DEAD_PROCESS, then getutid will return a pointer to 
the first entry whose type is one of these four and whose ut_id field matches 
id->ut_id. If the end of file is reached without a match, it fails. 


getutline searches the utmp file until it finds an entry of the type 
LOGIN_PROCESS or USER_PROCESS which also has a ut_line string match- 
ing the line->ut_line string. If the end of file is reached without a match, it 
fails. 


Pututline writes out the supplied utmp structure into the utmp file. It uses 
getutid to search forward for the proper place if it finds that it is not already 
at the proper place. It is expected that normally the user of pututline will 
have searched for the proper entry using one of the getut routines. If so, 
pututline will not search. If pututline does not find a matching slot for the 
new entry, it will add a new entry to the end of the file. 


setutent resets the input stream to the beginning of the file. This should be 
done before each search for a new entry if it is desired that the entire file be 
examined. 


NEW_TIME. If the type specified in id is INIT.PROCESS, LOGIN_PROCESS, @ 


endutent closes the currently open file. 


utmpname allows the user to change the name of the file examined, from 
/etc/utmp to any other file. It is most often expected that this other file will 
be /etc/wtmp. If the file does not exist, this will not be apparent until the 
first attempt to reference the file is made. utmpname does not open the file. 
It just closes the old file if it is currently open and saves the new file name. 


getutpid searches the utmp file for an entry of type INIT_.PROCESS, 
LOGIN_PROCESS, USER_PROCESS, or DEAD_PROCESS with a pid matching 
the pid in the structure passed to this routine. This procedure is a Sequent 
extension. 

ut_find_host provides a way to determine the host machine associated with a 
tty line. ut_find_host returns a pointer to a static character string. If there 
is no name associated with the tty line, a (char *) NULL is returned. This pro- 
cedure is a Sequent extension. 


ut_get_entry provides a way to read the utmp file records and any host asso- 
ciated with a utmp line. The two pieces of information are guaranteed to be 
correct at the time of the read. ut_get_entry returns a non-zero value on 
error or end-of-file. Zero is returned if ut_get_entry is successful, and the 
first argument is set to point to a static utmp structure. The pointer is 
overwritten at each call. The second argument points to a static character 
buffer. If there is no host associated with this line, the first character of the 
string is NULL. This procedure is a Sequent extension. The following code can 
be used to walk through the utmp file. 


struct utmp *u? 
char *h; 
int i = 1; 


while (ut_get_entry(&u, &h) == 0 { 
if (u->ut_line[0] != 0) 
printf("%d: line = %s host = %s\n", 
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i, u->ut_line, h); 
a4; 


FILES 
/etc/utmp 
/etc/utmp_dbm.dir 
/etc/utmp_dbm.pag 
/etc/wtmp 


SEE ALSO 
ttyslot(3C), utadduser(3x), utmp(4) 


DIAGNOSTICS 
ANULL pointer is returned upon failure to read, whether for permissions or 
having reached the end of file, or upon failure to write. 


WARNINGS 
The above routine uses <stdio.h>, which causes the size of programs not other- 
wise using standard I/O to increase more than expected. 


All information is saved in a static area, so it must be copied if it is to be 
saved. 


NOTES 
For performance reasons, the file /etc/utmp is hashed. When accessing this 
file, a seek is done directly to the entry to be read. The routine getutpid is an 
extension, also provided for performance reasons and, if used, results in code 
that is not portable. 


The most current entry is saved in a static structure. Multiple accesses 
require that it be copied before further accesses are made. 


The following is true only if utmpname has been called to access a file other 
than /etc/utmp. Calls to either getutid or getutline cause the routine to 
examine the static structure before performing more I/O. If the contents of the 
static structure match the search criteria, the routine stops searching. For 
this reason, to use getutline to search for multiple occurrences, it is neces- 
sary to zero out the static structure after each successful match, or getutline 
returns the same pointer over and over again. There is one exception to the 
rule about zeroing out the static structure before further reads are done. If 
the user has just modified the static structure and passed the pointer back to 
pututline, the implicit read done by pututline (if it finds that it is not 
already at the correct place in the file) does not change the contents of the 
static structure returned by the getutent, getutid or getutline routines. 


These routines use buffered standard V/O for input, but pututline uses an 
unbuffered non-standard write to avoid race conditions between processes try- 
ing to modify the utmp and wtmp files. 
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NAME 


hsearch, hcreate, hdestroy — manage hash search tables 


SYNOPSIS 


#include <search.h> 

ENTRY *hsearch (item, action) 
ENTRY item; 

ACTION action; 

int hcreate (nel) 

unsigned nel; 


void hdestroy ( ) 


DESCRIPTION 


NOTES 
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hsearch is a hash-table search routine generalized from Knuth (6.4) Algo- 
rithm D. It returns a pointer into a hash table indicating the location at 
which an entry can be found. item is a structure of type ENTRY (defined in 
the <search.h> header file) containing two pointers: item.key points to the 
comparison key, and item.data points to any other data to be associated with 
that key. (Pointers to types other than character should be cast to 
pointer-to-character.) action is a member of an enumeration type ACTION 
indicating the disposition of the entry if it cannot be found in the table. 
ENTER indicates that the item should be inserted in the table at an appropri- 
ate point. FIND indicates that no entry should be made. Unsuccessful resolu- 
tion is indicated by the return of a NULL pointer. 


hcreate allocates sufficient space for the table, and must be called before 
hsearch is used. nel is an estimate of the maximum number of entries that 
the table will contain. This number may be adjusted upward by the algorithm 
in order to obtain certain mathematically favorable circumstances. 


hdestroy destroys the search table, and may be followed by another call to 
hcreate. 


hsearch uses open addressing with a multiplicative hash function. However, 
its source code has many other options available which the user may select by 
compiling the hsearch source with the following symbols defined to the 
preprocessor: 


DIV Use the remainder modulo table size as the hash function 
instead of the multiplicative algorithm. 


USCR Use a User Supplied Comparison Routine for ascertaining 
table membership. The routine should be named hcompar 
and should behave in a mannner similar to stremp (see 
string(3C)). 


CHAINED 
Use a linked list to resolve collisions. If this option is 
selected, the following other options become available. 


START Place new entries at the beginning of the 
linked list (default is at the end). 


SORTUP Keep the linked list sorted by key in ascending 
order. 
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SORTDOWN 
Keep the linked list sorted by key in descend- 
ing order. 


Additionally, there are preprocessor flags for obtaining debugging printout 
(-DDEBUG) and for including a test driver in the calling routine (-DDRIVER). 
The source code should be consulted for further details. 


The following example will read in strings followed by two numbers and store 
them in a hash table, discarding duplicates. It will then read in strings and 
find the matching entry in the hash table and print it out. 


#include <stdio.h> 
#include <search.h> 


struct info { /* this is the info stored in the table * 
int age, room; /* other than the key. */ 

Ve 

#define NUM_EMPL 5000 /* # of elements in search table */ 


main( ) 
{ 
/* space to store strings */ 
char string_space [NUM_EMPL*20]; 
/* space to store employee info */ 
struct info info_space [NUM_EMPL]; © 
/* next avail space in string_space */ 


char *str_ptr = string_space; 
/* next avail space in info_space */ 
struct info *info_ptr = info_space; 


ENTRY item, *found_item, *hsearch( ); 
/* name to look for in table */ 
char name_to_find[30]; 

int i = 0; 


/* create table */ 
(void) hcreate (NUM_EMPL); 
while (scanf("%std%d", str_ptr, &info_ptr->age, 
&info_ptr->room) != EOF && i++ < NUM_EMPL) { 
/* put info in structure, and structure in item */ 
item.key = str_ptr; 


item.data = (char *)info_ptr; 
str_ptr += strlen(str_ptr) + 1; 
info_ptr++; 


/* put item into table */ 
(void) hsearch(item, ENTER); 
} 


/* access table */ 
item.key = name_to_find; 
while (scanf("%s", item.key) != EOF) { 
if ((found_item = hsearch(item, FIND)) != NULL) { 
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/* if item is in the table */ 

(void) printf("found %s, age = %d, room = %d\n", 
found_item->key, 
((struct info *)found_item->data) ->age, 
((struct info *)found_item->data)->room) ; 
} else { 

(void) printf("no such employee %s\n", 
name_to_find) 


} 


SEE ALSO 
bsearch(3C), lsearch(3C), malloc(3C), malloc(3X), string(3C), tsearch(3C) 


DIAGNOSTICS 
hsearch returns a NULL pointer if either the action is FIND and the item 
could not be found or the action is ENTER and the table is full. 


hcreate returns zero if it cannot allocate sufficient space for the table. 


WARNINGS 
hsearch and hcreate use malloc(3C) to allocate space. 


Only one hash search table may be active at any given time. 
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NAME 
isnan: isnand, isnanf — test for floating-point NaN (Not-A-Number) 


SYNOPSIS 
include <ieeefp.h> 


int isnand (dsrc) 
double dsrc; 


int isnanf (fsre) 
float fsrc; 


DESCRIPTION 
isnand and isnanf return true (1) ifthe argument dere or fsre is a NaN; 
otherwise they return false (0). 


Neither routine generates any exception, even for signaling NaNs. 
isnanf() is implemented as a macro included in <ieeefp.h>. 


SEE ALSO 
fpgetround(3C) 
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NAME 
18tol, 1tol3 — convert between 3-byte integers and long integers 
SYNOPSIS 


void I8tol (Ip, cp, n) 
long *lp; 

char *cp; 

int n; 

void Itol3 (cp, Ip, n) 
char *cp; 

long *lp; 

int n; 


DESCRIPTION 


18tol converts a list of n three-byte integers packed into a character string 
pointed to by cp into a list of long integers pointed to by Ip. 


ltol3 performs the reverse conversion from long integers (Ip) to three-byte 
integers (cp). 


These functions are useful for file-system maintenance where the block num- 
bers are three bytes long. 


SEE ALSO 


fs(4) 


WARNINGS 
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Because of possible differences in byte ordering, the numerical values of the 
long integers are machine-dependent. 
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NAME 


lockf — record locking on files 


SYNOPSIS 


#include <unistd.h> 


int lockf (fildes, function, size) 
long size; 
int fildes, function; 


DESCRIPTION 
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The lockf command allows sections of a file to be locked; advisory or manda- 
tory write locks depending on the mode bits of the file (see chmod(2)). Lock- 
ing calls from other processes which attempt to lock the locked file section will 
either return an error value or be put to sleep until the resource becomes 
unlocked. All the locks for a process are removed when the process termi- 
nates. (See fentl(2) for more information about record locking.) 


fildes is an open file descriptor. The file descriptor must have O_WRONLY or 
O_RDWR permission in order to establish lock with this function call. 


function is a control value which specifies the action to be taken. The per- 
missible values for function are defined in <unistd.h> as follows: 


#define F_ULOCK 0) /* Unlock a previously locked 
section */ 

#define F_LOCK x /* Lock a section for exclusive 
use */ 

#define F_TLOCK 2 /* Test and lock a section for 
exclusive use */ 

#define F_TEST 3 /* Test section for other 


processes locks */ 


All other values of function are reserved for future extensions and will result 
in an error return if not implemented. 


F_TEST is used to detect if a lock by another process is present on the specified 
section. F_LOCK and F_TLOCK both lock a section of a file if the section is 
available. F_ULOCK removes locks from a section of the file. 


size is the number of contiguous bytes to be locked or unlocked. The resource 
to be locked starts at the current offset in the file and extends forward for a 
positive size and backward for a negative size (the preceding bytes up to but 
not including the current offset). If size is zero, the section from the current 
offset through the largest file offset is locked (i.e., from the current offset 
through the present or any future end-of-file). An area need not be allocated 
to the file in order to be locked as such locks may exist past the end-of-file. 


The sections locked with F_LLOCK or F_TLOCK may, in whole or in part, con- 
tain or be contained by a previously locked section for the same process. 
When this occurs, or if adjacent sections occur, the sections are combined into 
asingle section. If the request requires that a new element be added to the 
table of active locks and this table is already full, an error is returned, and the 
new section is not locked. 
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F_LOCK and F_TLOCK requests differ only by the action taken if the resource 
is not available. F_LOCK will cause the calling process to sleep until the 
resource is available. F_TLOCK will cause the function to return a —1 and set 
errno to [EACCES] error if the section is already locked by another process. 


F_ULOCK requests may, in whole or in part, release one or more locked sec- 
tions controlled by the process. When sections are not fully released, the 
remaining sections are still locked by the process. Releasing the center sec- 
tion of a locked section requires an additional element in the table of active 
locks. If this table is full, an [EDEADLK] error is returned and the requested 
section is not released. 


A potential for deadlock occurs if a process controlling a locked resource is put 
to sleep by accessing another process’s locked resource. Thus calls to lockf or 
fent] scan for a deadlock prior to sleeping on a locked resource. An error 
return is made if sleeping on the locked resource would cause a deadlock. 


Sleeping on a resource is interrupted with any signal. The alarm(2) command 
may be used to provide a timeout facility in applications which require this 
facility. 

DIAGNOSTICS 
Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 
is returned and errno is set to indicate the error. 


lockf fails if any of the following are true: 
[EBADF] fildes is not a valid open descriptor. 


(EACCES) cmd is F_TLOCK or F_TEST and the section is already locked 
by another process. 


[EDEADLK] _ emd is F_LOCK and a deadlock would occur. Also the emd is 


either F_LOCK, F_TLOCK, or F_ULOCK, and the number of 
entries in the lock table would exceed the number allocated on 


the system. 
[ECOMM] fildes is on a remote machine and the link to that machine is 
no longer active. 
SEE ALSO 
chmod(2), close(2), creat(2), fentl(2), intro(2), open(2), read(2), write(2) 
WARNINGS 


Unexpected results may occur in processes that do buffering in the user 
address space. The process may later read/write data which is/was locked. 
The standard I/O package is the most common source of unexpected buffering. 


Because in the future the variable errno will be set to EAGAIN rather than 
EACCES when a section of a file is already locked by another process, portable 
application programs should expect and test for either value. 
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NAME 


lsearch, Ifind — linear search and update 


SYNOPSIS 


#include <stdio.h> 
#include <search.h> 


char *lsearch (key, base, nelp, sizeof(+*key), compar) 
char +key; 

char *base; 

unsigned *nelp; 

int (*compar)( ); 


char *lfind (key, base, nelp, sizeof(+key), compar) 
char +key; 

char *base; 

unsigned *nelp; 

int (*compar)( ); 


DESCRIPTION 


NOTES 


Isearch is a linear search routine generalized from Knuth (6.1) Algorithm S. 
It returns a pointer into a table indicating where a datum may be found. If 
the datum does not occur, it is added at the end of the table. key points to the 
datum to be sought in the table. base points to the first element in the table. 
nelp points to an integer containing the current number of elements in the 
table. The integer is incremented if the datum is added to the table. compar 
is the name of the comparison function which the user must supply (stremp, 
for example). It is called with two arguments that point to the elements being 
compared. The function must return zero if the elements are equal and non- 
zero otherwise. 


lIfind is the same as Isearch except that if the datum is not found, it is not 
added to the table. Instead, a NULL pointer is returned. 


The pointers to the key and the element at the base of the table should be of 
type pointer-to-element, and cast to type pointer-to-character. 


The comparison function need not compare every byte, so arbitrary data may 
be contained in the elements in addition to the values being compared. 


Although declared as type pointer-to-character, the value returned should be 
cast into type pointer-to-element. 


EXAMPLES 
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This fragment reads in less than TABSIZE strings of length less than ELSIZE 
and stores them in a table, eliminating duplicates. 


#include <stdio.h> 
#include <search.h> 


#define TABSIZE 50 
#define ELSIZE 120 


char line[ELSIZE], tab[TABSIZE] [ELSIZE], *lsearch( 
unsigned nel = 0; 
int stremp( ); 


i; 
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while (fgets(line, ELSIZE, stdin) != NULL && @ 
nel < TABSIZE) 
(void) lsearch(line, (char *)tab, &nel, 
ELSIZE, strcmp); 


SEE ALSO 
bsearch(3C), hsearch(3C), string(3C), tsearch(3C) 

DIAGNOSTICS 
If the searched for datum is found, both Isearch and Ifind return a pointer to 
it. Otherwise, find returns NULL and Isearch returns a pointer to the 
newly added element. 

BUGS 
Undefined results can occur if there is not enough room in the table to adda 
new item. 
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NAME 


malloc, free, realloc, calloc — main memory allocator 


SYNOPSIS 


char *malloc (size) 
unsigned size; 

void free (ptr) 

char *ptr; 

char *realloc (ptr, size) 
char *ptr; 

unsigned size; 

char *calloc (nelem, elsize) 
unsigned nelem, elsize; 


DESCRIPTION 


malloc and free provide a simple general-purpose memory allocation pack- 
age. malloc returns a pointer to a block of at least size bytes suitably 
aligned for any use. 


The argument to free is a pointer to a block previously allocated by malloc; 
after free is performed this space is made available for further allocation, but 
its contents are left undisturbed. 


Undefined results occur if the space assigned by malloc is overrun or if some 
random number is handed to free. 


malloc allocates the first big enough contiguous reach of free space found in a 
circular search from the last block allocated or freed, combining adjacent free 
blocks as it searches. It calls sbrk (see brk(2)) to get more memory from the 
system when there is no suitable space already free. 


realloc changes the size of the block pointed to by ptr to size bytes and 
returns a pointer to the (possibly moved) block. The contents will be 
unchanged up to the lesser of the new and old sizes. If no free block of size 
bytes is available in the storage arena, then realloc will ask malloc to 
enlarge the arena by size bytes and will then move the data to the new space. 


realloc also works if ptr points to a block freed since the last call of malloc, 
realloc, or calloc; thus sequences of free, malloc and realloc can exploit the 
search strategy of malloc to do storage compaction. 

calloc allocates space for an array of nelem elements of size elsize. The 
space is initialized to zeros. 

Each of the allocation routines returns a pointer to space suitably aligned 
(after possible pointer coercion) for storage of any type of object. 


SEE ALSO 


brk(2), malloc(3X) 


DIAGNOSTICS 
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malloc, realloc and calloc return a NULL pointer if there is no available 
memory or if the arena has been detectably corrupted by storing outside the 
bounds of a block. When this happens, the block pointed to by ptr may be des- 
troyed. 
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NOTES 
Search time increases when many objects have been allocated; that is, if a pro- @ 
gram allocates but never frees, then each successive allocation takes longer. 
For an alternate, more flexible implementation, see malloc(3X). 
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memory: memccpy, memchr, memcmp, memcpy, memset — memory operations 


SYNOPSIS 


#include <memory.h> 


char *memccpy (s1, s2, c, n) 
char *s1, *82; 

int c, n; 

char *memchr (s, c, n) 
char *s; 

int c, n; 

int memcmp (sl, s2, n) 
char *s1, *82; 

int n; 

char *memepy (s1, s2, n) 
char *s1, +82; 

int n; 

char *memeet (s, c, n) 
char *s; 

int c, n; 


DESCRIPTION 


These functions operate as efficiently as possible on memory areas (arrays of 
characters bounded by a count, not terminated by a null character). They do 
not check for the overflow of any receiving memory area. 


memccpy copies characters from memory area s2 into sl, stopping after the 
first occurrence of character c has been copied, or after n characters have 
been copied, whichever comes first. It returns a pointer to the character after 
the copy of ¢ in sl, or a NULL pointer if ¢ was not found in the first n charac- 
ters of s2. 

memcehr returns a pointer to the first occurrence of character c in the first n 
characters of memory area s, or a NULL pointer if ¢ does not occur. 

memcmp compares its arguments, looking at the first n characters only, and 
returns an integer less than, equal to, or greater than 0, according as s1 is lex- 
icographically less than, equal to, or greater than s2. 

memepy copies n characters from memory area s2 to sL It returns sL 
Warning: memcpy does not check that s1 and s2 overlap, as such, memcpy 
is not a direct replacement for the BSD beopy routine. 

memset sets the first n characters in memory area s to the value of character 
e. It returns s. 

For user convenience, all these functions are declared in the optional <mem- 
ory-h> header file. 


WARNINGS 


mememp is implemented by using the most natural character comparison on 
the machine. Thus the sign of the value returned when one of the characters 
has its high order bit set is not the same in all implementations and should 


not be relied upon. 
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Character movement is performed differently in different implementations. 
Thus overlapping moves may yield surprises. 
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NAME 
mkfifo — make a FIFO special file 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/stat.h> 


int mkfifo (path,mode) 
char *path; 
mode_t mode; 

DESCRIPTION 
The mkfifo routine creates a new FIFO special file named by the pathname 
path. The file permission bits of the new FIFO are initialized from mode. 
The file permission bits of mode are modified by the process’s file creation 
mask (see umask()). Bits in mode other than the file permission bits are 
ignored. 


The FIFO’s owner ID is set to the process’s efective user ID. The FIFO’s group 
ID is set to the group ID of the directory in which the FIFO is being created. 


Upon successful completion a value of zero is returned. Otherwise, a value of 
-1 is returned, no FIFO is created, and errno is set to indicate the error. 


If any of the following conditions occur, mkfifo() returns -1 and sets errno to 
the corresponding value: 


[EACCES] Acomponent of the path prefix denies search permis- 
sion. 
(EEXIST] The named file already exists. 


[ENAMETOOLONG] The length of the path string exceeds PATH_MAX, or 
a pathname component is longer than NAME_MAX. 


[ENOENT] Acomponent of the path prefix does not exist or the 
path argument points to an empty string. 

([ENOSPC] The directory that would contain the new file cannot 
be extended or the file system is out of file allocation 
resources. . 

(ENOTDIR] Acomponent of the path prefix is not a directory. 

[EROFS] The named file resides on a read-only file system. 

SEE ALSO 


chmod(1), exec(2), pipe(2), stat(5), umask(1) 
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NAME 
mktemp — make a unique filename 


SYNOPSIS 
char *mktemp (template) 
char *template; 

DESCRIPTION 
mktemp replaces the contents of the string pointed to by template by a 
unique filename, and returns the address of template. The string in tem- 
plate should look like a filename with six trailing Xs; mktemp will replace 
the Xs with a letter and the current process ID. The letter will be chosen so 
that the resulting name does not duplicate an existing file. 


SEE ALSO 
getpid(2), tmpfile(3S), tmpnam(3S) 


DIAGNOSTIC 
mktemp will assign to template the NULL string if it cannot create a 
unique name. 

WARNINGS 
If called more than 17,576 times in a single process, this function starts recy- 
cling previously used names. 
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NAME 


monitor — prepare execution profile 


SYNOPSIS 


#include <mon.h> 

void monitor (lowpc, highpce, buffer, bufsize, nfunc) 
int (tlowpc)( ), (*highpce)( ); 

WORD ‘buffer; 

int bufsize, nfunc; 


DESCRIPTION 


FILES 


An executable program created by cc -p automatically includes calls for mon- 
itor with default parameters; monitor need not be called explicitly except to 
gain fine control over profiling. 


monitor is an interface to profil(2). lowpe and highpe are the addresses of 
two functions; buffer is the address of a (user supplied) array of bufsize 
WORDs (defined in the <mon.h> header file). monitor arranges to record a 
histogram of periodically sampled values of the program counter, and of 
counts of calls of certain functions, in the buffer. The lowest address sampled 
is that of lowpe and the highest is just below highpe. lowpe may not equal 
0 for this use of monitor. At most nfunc call counts can be kept; only calls of 
functions compiled with the profiling option —p of cc(1) are recorded. 


For the results to be significant, especially where there are small, heavily used 
routines, it is suggested that the buffer be no more than a few times smaller 
than the range of locations sampled. 


To profile the entire program, it is sufficient to use the following: 


extern etext; 


nondtor ((int (*)())2, &etext, buf, bufsize, nfunc); 
etext lies just above all the program text; see end(3C). 
To stop execution monitoring and write the results, use the following; 
monitor ((int (*)())0, 0, 0, 0, 0); 
prof(1) can then be used to examine the results. 


The name of the file written by monitor is controlled by the environment 
variable PROFDIR. If PROFDIR does not exist, mon.out is created in the cur- 
rent directory. If PROFDIR exists but has no value; monitor does not do any 
profiling and creates no output file. Otherwise, the value of PROFDIR is used 
as the name of the directory in which to create the output file. If PROFDIR is 
then the file written is dirname/pid.mon.out where pid is the program’s pro- 
cess id. (When monitor is called automatically by compiling with ce -p, the 
file created is dirname/pid.progname where progname is the name of the 
program.) 


mon.out 


SEE ALSO 
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ce(1), prof(1), profil(2), end(3C) 
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BUGS 
The dirname/pid.mon.out form does not work; the dirname/pid.progname @ 
form (automatically called with ec —p) does work. 
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DYNIX/ptx NLIST(3C) 


NAME 
nlist — get entries from name list 


SYNOPSIS 
#include <nlist.h> 


int nlist (filename, nl) 
char *filename; 
struct nlist *nl; 

DESCRIPTION 
nlist examines the name list in the executable file whose name is pointed to 
by filename, and selectively extracts a list of values and puts them in the 
array of nlist structures pointed to by nl. The name list nl consists of an 
array of structures containing names of variables, types and values. The list 
is terminated with a null name; that is, a null string is in the name position of 
the structure. Each variable name is looked up in the name list of the file. If 
the name is found, the type and value of the name are inserted in the next two 
fields. The type field will be set to 0 unless the file was compiled with the -g 
option. If the name is not found, both entries are set to 0. See a.out(4) for a 
discussion of the symbol table structure. 


This function is useful for examining the system name list kept in the file 
/unix. In this way programs can obtain system addresses that are up to date. 


NOTES 
The <nlist.h> header file is automatically included by <a.out.h> for compa- 


tability. However, if the only information needed from <a.out.h> is for use of 
nlist, then including <a.out.h> is discouraged. If <a.out.h> is included, the 
line #undef n_name may need to follow it. 


SEE ALSO 
a.out(4) 


DIAGNOSTICS 
All value entries are set to 0 if the file cannot be read or if it does not contain a 


valid name list. 
nlist returns —1 upon error; otherwise it returns 0. 
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DYNIX/ptx PERROR(3C) 


NAME 


perror, errno, sys_errlist, sys_nerr — system error messages 


SYNOPSIS 


void perror (s) 
char *s; 


extern int errno; 
extern char *sys_errlist[ ]; 


extern int sys_nerr; 


DESCRIPTION 


perror produces a message on the standard error output, describing the last 
error encountered during a call to a system or library function. The argument 
string s is printed first, then a colon and a blank, then the message and a new- 
line. (However, if s="' the colon is not printed.) To be of most use, the argu- 
ment string should include the name of the program that incurred the error. 
The error number is taken from the external variable errno, which is set 
when errors occur but not cleared when non-erroneous calls are made. 


To simplify variant formatting of messages, the array of message strings 
sys_errlist is provided; errno can be used as an index into this table to get 
the message string without the new-line. sys_nerr is the number of mes- 
sages in the table; it should be checked because new error codes may be added 
to the system before they are added to the table. 


SEE ALSO 
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intro(2) 


DYNIX/ptx PUTENV(3C) 


NAME 
putenv — change or add value to environment 

SYNOPSIS 
int putenv (string) 
char *string; 

DESCRIPTION 
string points to a string of the form name=value. putenv makes the value 
of the environment variable name equal to value by altering an existing 
variable or creating a new one. In either case, the string pointed to by string 
becomes part of the environment, so altering the string will change the envi- 
ronment. The space used by string is no longer used once a new string-defin- 
ing name is passed to putenv. 


SEE ALSO 
exec(2), getenv(3C), malloc(3C), environ(5) 

DIAGNOSTICS 
putenv returns non-zero if it was unable to obtain enough space via malloc 
for an expanded environment, otherwise zero. 

WARNINGS 
putenv manipulates the environment pointed to by environ, and can be used 
in conjunction with getenv. However, envp (the third argument to main) is 
not changed. 


This routine uses malloc(3C) to enlarge the environment. 
After putenv is called, environmental variables are not in alphabetical order. 


A potential error is to call putenv with an automatic variable as the argu- 
ment, then exit the calling function while string is still part of the environ- 
ment. 
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DYNIX/ptx PUTPWENT(3C) 


NAME 
putpwent — write password file entry 


SYNOPSIS 
#include <pwd.h> 


int putpwent (p, f) 
struct passwd *p; 
FILE ¢f; 

DESCRIPTION 
putpwent is the inverse of getpwent(3C). Given a pointer to a passwd struc- 
ture created by getpwent (or getpwuid or getpwnam), putpwent writes a 
line on the stream f, which matches the format of /etc/passwd. 

SEE ALSO 
mkpwdbm((1), getpwent(3C) 

DIAGNOSTICS 
putpwent returns non-zero if an error was detected during its operation, 
otherwise zero. 

WARNINGS 
The above routine uses <stdio.h>, which causes an increase in the size of pro- 
grams, not otherwise using standard I/O, more than might be expected. 
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DYNIX/ptx QSORT(3C) 


NAME 


qsort — quicker sort 


SYNOPSIS 


void qsort ((char *) base, nel, sizeof (*base), compar) 
unsigned nel; 
int (*compar)( ); 


DESCRIPTION 


NOTES 


qsort is an implementation of the quicker-sort algorithm. It sorts a table of 
data in place. 

base points to the element at the base of the table. nel is the number of ele- 
ments in the table. compar is the name of the comparison function, which is 
called with two arguments that point to the elements being compared. As the 
function must return an integer less than, equal to, or greater than zero, so 
must the first argument to be considered be less than, equal to, or greater 
than the second. 


The pointer to the base of the table should be of type pointer-to-element, and 
cast to type pointer-to-character. 


The comparison function need not compare every byte, so arbitrary data may 
be contained in the elements in addition to the values being compared. 


The order in the output of two items which compare as equal is unpredictable. 


SEE ALSO 
sort(1), bsearch(3C), lsearch(3C), string(3C) 
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DYNIX/ptx RAND(3C) 


NAME 
rand, srand — simple random-number generator 
SYNOPSIS 
int rand ( ) 
void srand (seed) 
unsigned seed; 
DESCRIPTION 
rand uses a multiplicative congruential random-number generator with 
period 2°? that returns successive pseudorandom numbers in the range from 0 
to 2)5_1. 
srand can be called at any time to reset the random-number generator to a 
random starting point. The generator is initially seeded with a value of 1. 
NOTES 
The spectral properties of rand are limited. drand48(3C) provides a much 
better, though more elaborate, random-number generator. 


SEE ALSO 
drand48(3C) 
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NAME 


EXAMPLES 
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SETJMP(3C) 


setjmp, longjmp — non-local goto 


SYNOPSIS 
#include <setjmp.h> 


int setjmp (env) 
jmp_buf env; 


void longjmp (env, val) 
jmp_buf env; 

int val; 

DESCRIPTION 


These functions are useful for dealing with errors and interrupts encountered 
in a low-level subroutine of a program. 


setjmp saves its stack environment in env (whose type, is defined in the 
<setjmp.h> header file) for later use by longjmp. It returns the value 0. 


longjmp restores the environment saved by the last call of setjmp with the 
corresponding env argument. After longjmp is completed, program execu- 
tion continues as if the corresponding call of setjmp (which must not itself 
have returned in the interim) had just returned the value val. longjmp can- 
not cause setjmp to return the value 0. If longjmp is invoked with a second 
argument of 0, setjmp returns 1. At the time of the second return from 
setjmp, all external and static variables have values as of the time longjmp 
is called (see example). The values of register and automatic variables are 
undefined. 


In a future release, C language users will be able to identify syntactically 
those automatic variables on whose values they need to rely after the second 
return from setjmp. 


#include <set jmp.h> 


jmp_buf env; 


int 


i = 0; 


main () 


{ 


void exit(); 


if(setjmp(env) != 0) { 


} 


(void) printf ("value of i on 2nd return from setjmp: %d\n", i); 
exit (0); 


(void) printf("value of i on 1st return from setjmp: %d\n", i); 


i= Ls 
90; 
/*NOTREACHED*/ 


90) 
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longjmp(env, 1); 
/*NOTREACHED*/ 
} 


If the a.out resulting from this C language code is run, the 
output will be: 


value of i on Ist return from setjmp:0 


value of i on 2nd return from setjmp:1 
SEE ALSO 
signal(2), sigsetjmp(2) 
WARNINGS 
If longjmp is called even though env was never primed by a call to setjmp, 
or when the last such call was in a function that has since returned, absolute 
chaos is guaranteed. 
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DYNIX/ptx SETLOCALE(3C) 


NAME 


setlocale — set program’s location 


SYNOPSIS 


include <local.h> 

char *setlocale (category, locale) 
int category 

char *locale 


DESCRIPTION 
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The setlocale funciton selects the approprate portion of the program’s locale 
as specified by the category and locale arguments. setlocale may be used to 
change or query the program’s entire current locale or portions of it. A value 
of LC_ALL for category names the program’s entire locale; other values for 
category name only a portion of the program’s locale. LC_COLLATE affects 
the behavior of string collating functions. LC_CTYPE affects the behavior of 
character handling functions. LC_MONETARY affects monetary formatting 
information returned by various functions. LC_NUMERIC affects the deci- 
mal-point character for the formatted input-output functions and the string 
conversion functions. LC_TIME affects the behavior of strftime. 


The C Standard allows the specification of an implementation-defined native 
environment for the setlocale function, which sets a specific category to an 
implementation-defined default. For this system, this corresponds to the 
value of the environment variables. 


A specific category may be set to the value of its corresponding environment 
variable by passing the locale argument with a pointer to a null string. A 
value of "C" for locale specifies the minimal environment for C translation. 


Possible values for category in the order they are set are as follows: 


LC_CTYPE 
LC_COLLATE 
LC_TIME 
LC_NUMERIC 
LC_MONETARY 


In all cases when the locale argument is specified as a pointer to a null string, 
setlocale first checks the value of the corresponding environment variable 
(for example, LC_CTYPE for the LC_CTYPE category). If it is valid, that is, if 
it points to the name of a valid locale), setlocale sets the specified category of 
the international environment to that value, and returns the string corre- 
sponding to the locale set, that is, the value of the environment variable, not 
Ifthe value is invalid, setlocale returns a NULL pointer and the interna- 
tional environment is not changed. 

If the environment variable corresponding to the specified category is not set, 
or is set to an empty string, setlocale returns a NULL pointer and the locale 
remains unchanged, unless the LANG environment variable is set. If LANG is 
valid, setlocale sets the category to the corresponding value of LANG. To set 
all categories in the international environment, setlocale is invoked as fol- 
lows: 


setlocale (LC_ALL,""); 
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setlocale first checks all environment variables. If any environment variable 
is invalid, setlocale returns a NULL pointer and the international environ- 
ment is not changed. If all relevant environment variables are valid, setlo- 
cale sets the international environment to reflect the values of the environ- 
ment variables. 

Using this seheme, the categories corresponding to the environment variables 
override the value of the LANG environment variable for a particular cate- 
gory. 

At program startup, the equivalent of the following is executed: 


setlocale(LC_ALL, "C"); 


DIAGNOSTICS 
If a pointer to a string is given for locale and the selection can be honored, 
setlocale returns the string associated with the specified category for the new 
locale. If the selection cannot be honored, setlocale returns a NULL pointer 
and the program’s locale is not changed. 


ANULL pointer for locale causes setlocale to return the string associated 
with a category for the program’s current locale; the program’s locale is not 
changed. 

The string returned by setlocale is such that a subsequent call with that 
string and its associated category restores that part of the program’s locale. 
The string returned shall not be modified by the program, but may be 
overwritten by a subsequent call to setlocale. 
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DYNIX/ptx SIGSETJMP(3C) 


NAME 
sigsetjmp, siglongjmp — non-local jumps 


SYNOPSIS 
#include <setjmp.h> 


int sigsetjmp (env, savemask) 
sigjmp_buf env; 
int savemask; 
void siglongjmp (env, val) 
sigjmp_buf env; 
int val; 

DESCRIPTION 
The sigsetjmp macro complies with the definition of the setjmp macro in the 
C Standard. Ifthe value of savemask is not zero, sigsetjmp also saves the 
process’s current signal mask (see <signal.h>) as part of the calling environ- 
ment. 
The siglongjmp function complies with the definition of the longjmp func- 
tion in the C Standard. If and only if the env argument was initialized by a 
call to sigsetjmp with a non-zero savemask argument, siglongjmp restores 
the saved signal mask. 


SEE ALSO 
sigaction(2), sigprocmask(2), sigsuspend(2) 
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DYNIX/ptx SLEEP(3C) 


NAME 


sleep — suspend execution for interval 


SYNOPSIS 


unsigned sleep (seconds) 
unsigned seconds; 


DESCRIPTION 


The current process is suspended from execution for the number of seconds 
specified by the argument. The actual suspension time may be less than that 
requested for two reasons: (1) Because scheduled wakeups occur at fixed 1-sec- 
ond intervals, (on the second, according to an internal clock) and (2) because 
any caught signal will terminate the sleep following execution of that signal’s 
catching routine. Also, the suspension time may be longer than requested by 
an arbitrary amount due to the scheduling of other activity in the system. 

The value returned by sleep will be the “unslept” amount (the requested time 
minus the time actually slept) in case the caller had an alarm set to go off ear- 
lier than the end of the requested sleep time, or premature arousal due to 
another caught signal. 


The routine is implemented by setting an alarm signal and pausing until it (or 
some other signal) occurs. The previous state of the alarm signal is saved and 
restored. The calling program may have set up an alarm signal before calling 
sleep. If the sleep time exceeds the time till such alarm signal, the process 
sleeps only until the alarm signal would have occurred. The caller’s alarm 
catch routine is executed just before the sleep routine returns. But if the 
sleep time is less than the time till such alarm, the prior alarm time is reset 
to go off at the same time it would have without the intervening sleep. 


SEE ALSO 
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alarm(2), pause(2), signal(2) 


DYNIX/ptx SSIGNAL(3C) 


NAME 


ssignal, gsignal — software signals 


SYNOPSIS 


#include <signal.h> 

int (*ssignal (sig, action))( ) 
int sig, (*action)( ); 

int gsignal (sig) 

int sig; 


DESCRIPTION 


ssignal and gsignal implement a software facility similar to signal(2). This 
facility is used by the Standard C Library to enable users to indicate the dis- 
position of error conditions, and is also made available to users for their own 
purposes. 

Software signals made available to users are associated with integers in the 
range 1 through 16 inclusive. A call to ssignal associates a procedure, 
action, with the software signal sig; the software signal, sig, is raised by a 
call to gsignal. Raising a software signal causes the action established for 
that signal to be taken. 

The first argument to ssignal is a number identifying the type of signal for 
which an action is to be established. The second argument defines the action; 
it is either the name of a (user-defined) action function or one of the mani- 
fest constants SIG_DFL (default) or SIG_IGN (ignore). ssignal returns the 
action previously established for that signal type; if no action has been esta- 
blished or the signal number is illegal, ssignal returns SIG_DFL. 


gsignal raises the signal identified by its argument, sig: 
If an action function has been established for sig, then that action is 


reset to SIG_DFL and the action function is entered with argument sig. 
gsignal returns the value returned to it by the action function. 


If the action for sig is SIG_IGN, gsignal returns the value 1 and takes 
no other action. 
If the action for sig is SIG_DFL, gsignal returns the value 0 and takes 
no other action. 


If sig has an illegal value or no action was ever specified for sig, gsig- 
nal returns the value 0 and takes no other action. 


SEE ALSO 


signal(2), sigset(2), sigaction(2) 


NOTES 
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There are some additional signals with numbers outside the range 1 through 
16 which are used by the Standard C Library to indicate error conditions. 
Thus, some signal numbers outside the range 1 through 16 are legal, although 
their use may interfere with the operation of the Standard C Library. 


DYNIX/ptx STDIPC(3C) 


NAME 


stdipe: ftok — standard interprocess communication package 


SYNOPSIS 


#include <sys/types.h> 
#include <sys/ipe.h> 
key_t ftok(path, id) 
char *path; 

char id; 


DESCRIPTION 


All interprocess communication facilities require the user to supply a key to 
be used by the msgget(2), semget(2), and shmget(2) system calls to obtain 
interprocess communication identifiers. One suggested method for forming a 
key is to use the ftok subroutine described below. Another way to compose 
keys is to include the project ID in the most significant byte and to use the 
remaining portion as a sequence number. There are many other ways to form 
keys, but it is necessary for each system to define standards for forming them. 
If some standard is not adhered to, it is possible for unrelated processes to 
unintentionally interfere with each other’s operation. Therefore, it is strongly 
suggested that the most significant byte of a key in some sense refer to a proj- 
ect so that keys do not conflict across a given system. 


ftok returns a key based on path and id that is usable in subsequent 
msgget, semget, and shmget system calls. path must be the pathname of 
an existing file that is accessible to the process. id is a character which 
uniquely identifies a project. Note that ftok returns the same key for linked 
files when called with the same id and that it returns different keys when 
called with the same filename but different ids. 


SEE ALSO 


intro(2), msgget(2), semget(2), shmget(2) 


DIAGNOSTICS 


ftok returns (key_t) -lif path does not exist or if it is not accessible to the 
process. 


WARNINGS 
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If the file whose path is passed to ftok is removed when keys still refer to the 
file, future calls to ftok with the same path and id return an error. Ifthe 
same file is recreated, then ftok is likely to return a different key than it did 
the original time it was called. 


DYNIX/ptx STRFTIME(3C) 


NAME 


strftime — format time information 


SYNOPSIS 


#include <time.h> 

int strftime (s, maxsize, format, tm) 
char *s; 

char *format; 

struct tm *timeptr; 


DESCRIPTION 
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The strftime function places characters into the array pointed to by s as con- 
trolled by the string pointed to by format. The format string is a multibyte 
character sequence, beginning and ending in its initial shift state. The for- 
mat string consists of zero or more conversion specifications and ordinary 
multibyte characters. A conversion specification consists of a % character fol- 
lowed by a charater that determines the conversion specification’s behavior. 
All ordinary multibyte characters (including the terminating NULL character) 
are copied unchanged into the array. If copying takes place between objects 
that overlap, the behavior is undefined. No more than maxsize characters 
are placed into the array. Each conversion specification is replaced by appro- 
priate characters as described in the following list. The appropriate charac- 
ters are determined by the program’s locale and by the values contained in the 
structure pointed to by timeptr. If a conversion specification is not one of 
these, the behavior is undefined. 


%a is replaced by the locale’s abbreviated weekday name. 

%A is replaced by the locale’s full weekday name. 

%b is replaced bby the locale’s abbreviated month name. 

%B_ isreplaced by the locale’s full month name. 

%c is replaced by the locale’s appropriate date and time representation. 
%d_ is replaced by the day of the month as a decimal number (01-31). 
%H_ is replaced by the hour (24-hour clock) as a decimal number (00-23). 
%I is replaced by the hour (12-hour clock) as a decimal number (01-12). 
%j is replaced by the day of the year as a decimal number (001-366). 
%m_ is replaced by the month as a decimal number (01-12). 

%M_ is replaced by the minute as a decimal number (00-59). 

%P is replaced by the locale’s equivalent of either AM or PM. 

%S is replaced by the second as a decimal number (00-60). 


%U_ is replaced by the week number of the year (Sunday as the first day of 
the week) as a decimal number (00-53). 


%w is replaced by the weekday as a decimal number [0 (Sunday)-6]. 


%W is replaced by the week number of the year (Monday as the first of the 
week) as a decimal number (00-53). 


%x is replaced by the locale’s appropriate date representation. 
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%X 
toy 
%Y 
lL, 


%% 


is replaced by the locale’s appropriate time representation. © 
is replaced by the year without century as a decimal number (00-99). 


is replaced by the year with century as a decimal number. 


is replaced by the time zone name, or by no characters if no time zone is 
determinable. 


is replaced by % 


DIAGNOSTICS 
If the total number of resulting characters, including the terminating NULL 
character, is not more than maxsize, strftime returns the number of charac- 
ters placed into the array pointed to by s, not including the terminating NULL 
charcter. Otherwise, zero is returned and the contents of the array are 
indetermininate. 
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NAME 


STRING(3C) 


string: strcat, strdup, strncat, strcmp, strncmp, strcpy, strnepy, strlen, strchr, 


strrchr, strpbrk, strspn, strespn, strtok — string operations 


SYNOPSIS 


#include <string.h> 
#include <sys/types.h> 
char *streat (s1, s2) 
char *s1, +82; 

char *strdup (s1) 
char *s1; 

char *strncat (s1, 82, n) 
char *s1, *s2; 

size_t n; 

int stremp (sl, s2) 
char *s], *s2; 

int strncemp (s1, s2, n) 
char *s1, *82; 

size_t n; 

char *strepy (sl, s2) 
char *s1, *82; 

char *strnepy (s1, 52, n) 
char *s1, +82; 

size_t n; 

int strlen (s) 

char *s; 

char *strchr (s, c) 
char *8; 

int c; 

char *strrchr (s, c) 
char *s; 

int ¢; 

char *strpbrk (s1, s2) 
char *s1, *s2; 

int strspn (s1, s2) 
char *s1, *82; 

int strespn (s1, s2) 
char *s1, *82; 

char *strtok (s1, s2) 
char *s1, *82; 


DESCRIPTION 
The arguments s1, s2 and s point to strings (arrays of characters terminated 
by a NULL character). The functions streat, strncat, strepy, and all alter sL 
These functions do not check for overflow of the array pointed to by sL 
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streat appends a copy of string s2 to the end of string sL 


strdup returns a pointer to a new string which is a duplicate of the string 
pointed to by sl. The space for the new string is obtained using malloc(3C). If 
the new string can not be created, NULL is returned. 


strncat appends at most n characters. Each returns a pointer to the 
NULL-terminated result. 


strcmp compares its arguments and returns an integer less than, equal to, or 
greater than 0, according as s1 is lexicographically less than, equal to, or 
greater than s2. strncmp makes the same comparison but looks at at most n 
characters. 

strepy copies string s2 to sl, stopping after the NULL character has been 
copied. strnepy copies exactly mn characters, truncating s2 or adding NULL 
characters to sl if necessary. The result is not NULL—terminated if the length 
of s2 ism or more. Each function returns sL 

strlen returns the number of characters in s, not including the terminating 
NULL character. 

strchr (strrchr) returns a pointer to the first (last) occurrence of character ¢ 
in string s, or a NULL pointer if ¢ does not occur in the string. The NULL 
character terminating a string is considered to be part of the string. 


strpbrk returns a pointer to the first occurrence in string s1 of any character 
from string s2, or a NULL pointer if no character from s2 exists in sL 


strspn (strespn) returns the length of the initial segment of string s1 which 
consists entirely of characters from (not from) string s2. 


Strtok considers the string s1 to consist of a sequence of zero or more text 
tokens separated by spans of one or more characters from the separator string 
s2. The first call (with pointer s1 specified) returns a pointer to the first char- 
acter of the first token, and will have written a NULL character into s1 imme- 
diately following the returned token. The function keeps track of its position 
in the string between separate calls, so that subsequent calls (which must be 
made with the first argument a NULL pointer) will work through the string s1 
immediately following that token. In this way subsequent calls will work 
through the string s1 until no tokens remain. The separator string s2 may be 
different from call to call. When no token remains in s1, a NULL pointer is 
returned. 


For user convenience, all these functions are declared in the optional 
<string.h> header file. 


SEE ALSO 
malloc(3C), malloc(3X) 


WARNINGS 
strcmp and strncmp are implemented by using the most natural character 
comparison on the machine. Thus the sign of the value returned when one of 
the characters has its high-order bit set not the same in all implementations 
and should not be relied upon. 


Character movement is performed differently in different implementations. 
Thus overlapping moves may yield surprises. 
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DYNIX/ptx STRSTR(3C) 


NAME 
strstr — find first occurrence of character 


SYNOPSIS 
#include <string.h> 
char *strstr (s1, 82); 
char *s1; 
char *s2; 

DESCRIPTION 
The strstr function locates the first occurrence in the string pointed to by sl 
of the sequence of characters (excluding the terminating null character) in the 
string pointed to by s2. 

DIAGNOSTICS 
The strstr function returns a pointer to the located string, or a NULL pointer 
if the string is not found. If s2 points to a string with zero length, the function 
returns sl, 
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DYNIX/ptx STRTOD(3C) 


NAME 


strtod, atof — convert string to double-precision number 


SYNOPSIS 


double strtod (str, ptr) 
char *str, **ptr; 


double atof (str) 
char *str; 


DESCRIPTION 


strtod returns as a double-precision floating-point number the value repre- 
sented by the character string pointed to by str. The string is scanned up to 
the first unrecognized character. 


strtod recognizes an optional string of white-space characters (as defined by 
isspace in ctype(3C)), then an optional sign, then a string of digits optionally 
containing a decimal point, then an optional e or E followed by an optional 
sign or space, followed by an integer. 


If the value of ptr is not (char **)NULL, a pointer to the character terminat- 
ing the scan is returned in the location pointed to by ptr. If no number can be 
formed, *ptr is set to str, and zero is returned. 


atof(str) is equivalent to strtod(str, (char **)NULL). 


SEE ALSO 


ctype(3C), scanf(3S), strtol(3C) 


DIAGNOSTICS 
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If the correct value would cause overflow, +HUGE (as defined in <math.h>) is 
returned (according to the sign of the value), and errno is set to ERANGE. 

If the correct value would cause underflow, zero is returned and errno is set 
to ERANGE. 
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NAME 
strtol, atol, atoi — convert string to integer 

SYNOPSIS 
long strtol (str, ptr, base) 
char *str, **ptr; 
int base; 
long atol (str) 
char ¢str; 
int atoi (str) 
char *str; 

DESCRIPTION 
strtol returns as a long integer the value represented by the character string 
pointed to by str. The string is scanned up to the first character inconsistent 
with the base. Leading white-space characters (as defined by isspace in 
ctype(3C)) are ignored. 
If the value of ptr is not (char **)NULL, a pointer to the character terminat- 
ing the scan is returned in the location pointed to by ptr. If no integer can be 
formed, that location is set to str, and zero is returned. 


If base is positive (and not greater than 36), it is used as the base for conver- 
sion. After an optional leading sign, leading zeros are ignored, and “Ox” or 
“OX” is ignored if base is 16. 


If base is zero, the string itself determines the base thusly: After an optional 
leading sign a leading zero indicates octal conversion, and a leading “Ox” or 
“OX” hexadecimal conversion. Otherwise, decimal conversion is used. 


Truncation from long to int can, of course, take place upon assignment or by 
an explicit cast. 


atol(str) is equivalent to strtol(str, (char **)NULL, 10). 
atoi(str) is equivalent to (int) strtol(str, (char +*)NULL, 10). 


SEE ALSO 
ctype(3C), scanf(3S), strtod(3C) 


WARNINGS 
Overflow conditions are ignored. 
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NAME 
swab — swap bytes 

SYNOPSIS 
void swab (from, to, nbytes) 
char *from, *to; 
int nbytes; 

DESCRIPTION 
swab copies nbytes bytes pointed to by from to the array pointed to by to, 
exchanging adjacent even and odd bytes. nbytes should be even and non-neg- 
ative. If nbytes is odd and positive swab uses nbytes—1 instead. If nbytes 
is negative, swab does nothing. ‘ 
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NAME 


tsearch, tfind, tdelete, twalk — manage binary search trees 


SYNOPSIS 


#include <search.h> 


char *tsearch (key, rootp, compar) 
char *key; 

char *rootp; 

int (*compar)( ); 

char *tfind (key, rootp, compar) 
char *key; 

char *rootp; 

int (*compar)( ); 


char *tdelete (key, rootp, compar) 
char *key; 

char *rootp; 

int (*compar)( ); 

void twalk (root, action) 

char *root; 

void (*action)( ); 


DESCRIPTION 
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tsearch, tfind, tdelete, and twalk are routines for manipulating binary 
search trees. They are generalized from Knuth (6.2.2) Algorithms T and D. 
All comparisons are done with a user-supplied routine. This routine is called 
with two arguments, the pointers to the elements being compared. It returns 
an integer less than, equal to, or greater than 0, according to whether the first 
argument is to be considered less than, equal to or greater than the second 
argument. The comparison function need not compare every byte, so arbitrary 
data may be contained in the elements in addition to the values being com- 
pared. 


tsearch is used to build and access the tree. key is a pointer to a datum to be 
accessed or stored. If there is a datum in the tree equal to +key (the value 
pointed to by key), a pointer to this found datum is returned. Otherwise, 
+key is inserted, and a pointer to it returned. Only pointers are copied, so the 
calling routine must store the data. rootp points to a variable that points to 
the root of the tree. A NULL value for the variable pointed to by rootp 
denotes an empty tree; in this case, the variable will be set to point to the 
datum which will be at the root of the new tree. 


Like teearch, tfind searches for a datum in the tree, returning a pointer to it 
if found. However, ifit is not found, tfind will return a NULL pointer. The 
arguments for tfind are the same as for tsearch. 


tdelete deletes a node from a binary search tree. The arguments are the 
same as for tsearch. The variable pointed to by rootp will be changed if the 
deleted node was the root of the tree. tdelete returns a pointer to the parent 
of the deleted node, or a NULL pointer if the node is not found. 


twalk traverses a binary search tree. root is the root of the tree to be tra- 
versed. (Any node in a tree may be used as the root for a walk below that 
node.) action is the name of a routine to be invoked at each node. This 
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routine is, in turn, called with three arguments. The first argument is the 
address of the node being visited. The second argument is a value from an 
enumeration data type typedef enum { preorder, postorder, endorder, 
leaf } VISIT; (defined in the <search.h> header file), depending on whether 
this is the first, second or third time that the node has been visited (during a 
depth-first, left-to-right traversal of the tree), or whether the node is a leaf. 
The third argument is the level of the node in the tree, with the root being 
level zero. 


The pointers to the key and the root of the tree should be of type 
pointer-to-element, and cast to type pointer-to-character. Similarly, although 
declared as type pointer-to-character, the value returned should be cast into 
type pointer-to-element. 


EXAMPLES 
The following code reads in strings and stores structures containing a pointer 
to each string and a count of its length. It then walks the tree, printing out 
the stored strings and their lengths in alphabetical order. 


#include <search.h> 
#include <stdio.h> 


struct node { /* pointers to these are */ 
/* stored in the tree */ 
char *string; 
int length; 
Me 
char string_space[10000]; 
/* space to store strings */ 
struct node nodes[500]; /* nodes to store */ 
struct node *root = NULL; 
/* this points to the root */ 


main( ) 

{ 
char *strptr = string_space; 
struct node *nodeptr = nodes; 
void print_node( ), twalk( ); 
int i = 0, node_compare( ); 


while (gets(strptr) != NULL && i++ < 500) { 
/* set node */ 
nodeptr->string = strptr; 
nodeptr->length = strlen(strptr); 
/* put node into the tree */ 
(void) tsearch{ (char *)nodeptr, (char **) &root, 
node_compare) ; 
/* adjust pointers, so we */ 
/* don’t overwrite tree */ 
strptr += nodeptr->length + 1; 
nodeptr++; 
} 


twalk((char *) root, print_node); 
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[* 
This routine compares two nodes, based on an 
alphabetical ordering of the string field. 
of 
int 


node_compare (nodel, node2) 

char *nodel, *node2; 

{ 
return strcemp(((struct node *)nodel)->string, 
({struct node *) node2)->string); 


Je 
This routine prints out a node, the first time 
twalk encounters it. 

ey 

void 


print_node (node, order, level) 
char **node; 
VISIT order; 


int level; 
{ 
if (order == preorder || order == leaf) { 
(void) printf ("string = %20s, length = %d\n", 
(*((struct node **)node))->string, 
(*((struct node **)node))->length) ; 
} 
} 
SEE ALSO 


bsearch(3C), hsearch(3C), lsearch(3C) 


DIAGNOSTICS 


ANULL pointer is returned by tsearch if there is not enough space available 
to create a new node. 

ANULL pointer is returned by tfind and tdelete if rootp is NULL on entry. 
If the datum is found, both tsearch and tfind return a pointer to it. If not, 
tfind returns NULL, and tsearch returns a pointer to the inserted item. 


WARNINGS 
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The root argument to twalk is one level of indirection less than the rootp 
arguments to tsearch and tdelete. 


There are two nomenclatures used to refer to the order in which tree nodes 
are visited. tsearch uses preorder, postorder and endorder to respectively 
refer to visting a node before any of its children, after its left child and before 
its right, and after both its children. The alternate nomenclature uses 
preorder, inorder and postorder to refer to the same visits, which could result 
in some confusion over the meaning of postorder. 


If the calling function alters the pointer to the root, results are unpredictable. 
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NAME 
ttyname, isatty — find name of a terminal 


SYNOPSIS 
char *ttyname (fildes) 
int fildes; 


int isatty (fildes) 
int fildes; 
DESCRIPTION 
ttyname returns a pointer to a string containing the NULL-terminated path 
name of the terminal device associated with file descriptor fildes. 


First ttyname calls the dev_to_ttyname procedure to rapidly generate a 
potiental pathname for the terminal. Ifthe device node for the path returned 
matches the device specified by fildes the pathname is returned immediately. 
If the device node does not match, ttyname will search in the /dev directory 
until a match is found. 


isatty returns 1 if fildes is associated with a terminal device, 0 otherwise. 


FILES 
/dev/* /dev/tty* 

DIAGNOSTICS 
ttyname returns a NULL pointer if fildes does not describe a terminal device 
in directory /dev. 

WARNINGS 
The return value points to static data whose content is overwritten by each 
call. 


SEE ALSO 
dev_to_ttyname(3C) 
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NAME 
ttyslot — find the slot in the utmp file of the current user 


SYNOPSIS 
int ttyslot ( ) 

DESCRIPTION 
ttyslot returns the index of the current user’s entry in the /etc/utmp file. 
This is accomplished by actually scanning the file /etc/inittab for the name of 
the terminal associated with the standard input, the standard output, or the 
error output (0, 1 or 2). 


FILES 
/etc/inittab 
/etc/utmp 

SEE ALSO 
getut(3C), ttyname(3C) 

DIAGNOSTICS 
A value of -1 is returned if an error was encountered while searching for the 
terminal name or if none of the above file descriptors is associated with a ter- 
minal device. 
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NAME 


bessel: jO, j1, jn, yO, y1, yn — Bessel functions 


SYNOPSIS 


#include <math.h> 


double jO (x) 
double x; 
double jl (x) 
double x; 
double jn (n, x) 
int n; 

double x; 
double yO (x) 
double x; 
double yl (x) 
double x; 
double yn (n, x) 
int n; 

double x; 


DESCRIPTION 


jO and jl return Bessel functions of x of the first kind of orders 0 and 1 respec- 
tively. jn returns the Bessel function of x of the first kind of order n. 


yO and yl return Bessel functions of x of the second kind of orders 0 and 1 
respectively. yn returns the Bessel function of x of the second kind of order 
n. The value of x must be positive. 


SEE ALSO 


matherr(3M) 


DIAGNOSTICS 
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Non-positive arguments cause yO, yl and yn to return the value -HUGE and 
to set errno to EDOM. In addition, a message indicating DOMAIN error is 
printed on the standard error output. 


Arguments too large in magnitude cause jO, jl, yO and y1 to return zero and to 
set errno to ERANGE. In addition, a message indicating TLOSS error is 
printed on the standard error output. 

These error-handling procedures may be changed with the function math- 


err(3M). 


DYNIX/ptx ERF(3M) 


NAME 
erf, erfe — error function and complementary error function 


SYNOPSIS 
#include <math.h> 


double erf (x) 
double x; 


double erfe (x) 
double x; 


DESCRIPTION a 
erf returns the error function of x, defined as ~ Je+? dt. 
To 
erfc, which returns 1.0 — erf(x), is provided because of the extreme loss of rel- 


ative accuracy if erf(x) is called for large x and the result subtracted from 1.0 
(e.g., for x = 5, 12 places are lost). 


SEE ALSO 
exp(3M) 
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NAME 
@ exp, log, log10, pow, sqrt — exponential, logarithm, power, square root func- 
tions 
SYNOPSIS 
#include <math.h> 


double exp (x) 
double x; 


double log (x) 
double x; 


double log10 (x) 
double x; 


double pow (x, y) 
double x, y; 


double sqrt (x) 
double x; 


DESCRIPTION 
exp returns e*, 
log returns the natural logarithm of x. The value of x must be positive. 
log10 returns the logarithm base ten of x. The value of x must be positive. 


pow returns x”, If x is zero, y must be positive. If x is negative, y must be 


& an integer. 
sqrt returns the non-negative square root of x. The value of x may not be 
negative. 
SEE ALSO 
hypot(3M), matherr(3M), sinh(3M). 
DIAGNOSTICS 


exp returns HUGE when the correct value would overflow, or 0 when the cor- 
rect value would underflow, and sets errno to ERANGE. 


log and log10 return -HUGE and set errno to EDOM when x is non-positive. 
A message indicating DOMAIN error (or SING error when x is 0) is printed 
on the standard error output. 


pow returns 0 and sets errno to EDOM when x is 0 and y is non-positive, or 
when x is negative and y is not an integer. In these cases a message indicat- 
ing DOMAIN error is printed on the standard error output. When the correct 
value for pow would overflow or underflow, pow returns +HUGE or 0 respec- 
tively, and sets to ERANGE. 


sqrt returns 0 and sets errno to EDOM when x is negative. A message indi- 
cating DOMAIN error is printed on the standard error output. 


These error-handling procedures may be changed with the function math- 


err(3M). 
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NAME 


floor, ceil, fmod, fabs — floor, ceiling, remainder, absolute value functions 


SYNOPSIS 


#include <math.h> 
double floor (x) 
double x; 

double ceil (x) 
double x; 

double fmod (x, y) 
double x, y; 


double fabs (x) 
double x; 


‘DESCRIPTION 


floor returns the largest integer (as a double-precision number) not greater 
than x. 


ceil returns the smallest integer not less than x. 


fmod returns the floating-point remainder of the division of x by y: x ify is 
zero or if x/y would overflow; otherwise the number f with the same sign as x, 
such that x = iy + f for some integeri, and I fl<lyl. 


fabs returns the absolute value of x, | x |. 


SEE ALSO 
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abs(3C) 
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NAME 
gamma — log gamma function 


SYNOPSIS 
#include <math.h> 


double gamma (x) 

double x; 

extern int signgam; 
DESCRIPTION 


gamma returns In( | I(x) | ), where I(x) is defined as feet. The sign 


0 
of (x) is returned in the external integer signgam. The argument x may 
not be a non-positive integer. 


The following C program fragment might be used to calculate I: 
if ((y = gamma(x)) > LN_MAXDOUBLE) 
error(); 
y = signgam * exp(y); 
where LN_MAXDOUBLE is the least value that causes exp(3M) to return a 
range error, and is defined in the <values.h> header file. 


SEE ALSO 
exp(3M), matherr(3M), values(5) 


DIAGNOSTICS 
For non-negative integer arguments HUGE is returned, and errno is set to 
EDOM. A message indicating SING error is printed on the standard error out- 
put. 
If the correct value would overflow, gamma returns HUGE and sets errno to 
ERANGE, 


These error-handling procedures may be changed with the function math- 


err(3M). 
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NAME 
hypot — Euclidean distance function 


SYNOPSIS 
#include <math.h> 


double hypot (x, y) 

double x, y; 
DESCRIPTION 

hypot returns 

sqrix *x+y*y), 

taking precautions against unwarranted overflows. 
SEE ALSO 

matherr(3M) 


DIAGNOSTICS 
When the correct value would overflow, hypot returns HUGE and sets errno 
to ERANGE. 


These error-handling procedures may be changed with the function math- 
err(3M). 
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NAME 
matherr — error-handling function 


SYNOPSIS 
#include <math.h> 


int matherr (x) 
struct exception *x; 


DESCRIPTION 
matherr is invoked by functions in the Math Library when errors are 
detected. Users may define their own procedures for handling errors, by 
including a function named matherr in their programs. matherr must be of 
the form described above. When an error occurs, a pointer to the exception 
structure x will be passed to the user-supplied matherr function. This struc- 
ture, which is defined in the <math.h> header file, is as follows: 


struct exception { 
int type; 
char *name; 
double argl, arg2, retval; 
Me 
The element type is an integer describing the type of error that has occurred, 
from the following list of constants (defined in the header file): 


DOMAIN argument domain error 
SING argument singularity 
OVERFLOW overflow range error 
UNDERFLOW underflow range error 
TLOSS total loss of significance 
PLOSS partial loss of significance 


The element name points to a string containing the name of the function that 
incurred the error. The variables argl and arg2 are the arguments with 

which the function was invoked. retval is set to the default value that will be 
returned by the function unless the user’s matherr sets it to a different value. 


Ifthe user’s matherr function returns non-zero, no error message will be 
printed, and errno will not be set. 


If matherr is not supplied by the user, the default error-handling procedures, 
described with the math functions involved, will be invoked upon error. These 
procedures are also summarized below. In every case, errno is set to EDOM 
or ERANGE and the program continues. 


EXAMPLES 
#include <math.h> 


int 
matherr (x) 
register struct exception *x; 
{ 
switch (x->type) { 
case DOMAIN: 
/* change sqrt to return sqrt(-argl), */ 
/* not 0 */ 
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41f£ (!stremp(x->name, "sqrt")) { 
x->retval = sqrt (-x->argl); 
return (0); /* print message and set errno */ 


} 
case SING: 
/* all other domain or sing errors, */ 
/* print message and abort */ 
fprintf(stderr, "domain error in %s\n", x->name); 
abort ( ); 
case PLOSS: 
/* print detailed error message */ 
fprintf(stderr, "loss of significance in %s(%g) = %g\n", 
xX->name, x->argl, x->retval); 
return (1); /* take no other action */ 
} 
return (0); /* all other errors, execute */ 
/* default procedure */ 


DEFAULT ERROR HANDLING PROCEDURES 


BESSEL: TLOSS [ERANGE] returns a message or 0 
PLOSS [ERANGE] returns as much of the value as possible 


y0, yl, 

yn (arg <=0) DOMAIN [EDOM] returns a message or -HUGE 

EXP: OVERFLOW [ERANGE] returns HUGE 
UNDERFLOW [ERANGE] returns 0 

LOG, LOG10: 

(a <0) DOMAIN [EDOM] returns a message or -HUGE 

(arg = 0) SING [EDOM] returns a message of -HUGE 

POW: OVERFLOW [ERANGE] returns HUGE or -HUGE 
UNDERFLOW [ERANGE] returns 0 

neg 


** non-int DOMAIN [EDOM] returns a message or 0 


SQRT: DOMAIN [EDOM] return a message or 0 

GAMMA: SING [EDOM] returns a message or HUGE 
HYPOT: OVERFLOW (ERANGE] returns HUGE 

SINH: OVERFLOW [ERANGE] returns HUGE or -HUGE 
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OVERFLOW [ERANGE] returns HUGE 


UNDERFLOW [ERANGE] returns a message or 0 
TLOSS returns as much of the value as possible 


DOMAIN [EDOM] returns a message or 0 


DYNIX/ptx SINH(3M) 


NAME 

sinh, cosh, tanh — hyperbolic functions 
SYNOPSIS 

#include <math.h> 


double sinh (x) 
double x; 


double cosh (x) 
double x; 


double tanh (x) 
double x; 

DESCRIPTION 
sinh, cosh, and tanh return, respectively, the hyberbolic sine, cosine and 
tangent of their argument. 

SEE ALSO 
matherr(3M) 

DIAGNOSTICS 
sinh and cosh return HUGE (and sinh may return -HUGE for negative x) 
when the correct value would overflow and set errno to ERANGE. 
These error-handling procedures may be changed with the function math- 
err(3M). 
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NAME 


trig: sin, cos, tan, asin, acos, atan, atan2 — trigonometric functions 


SYNOPSIS 


#include <math.h> 
double sin (x) 
double x; 


double cos (x) 
double x; 


double tan (x) 
double x; 


double asin (x) 
double x; 
double acos (x) 
double x; 
double atan (x) 
double x; 


double atan2 (y, x) 
double y, x; 


DESCRIPTION 


sin, cos and tan return respectively the sine, cosine and tangent of their 
argument, x, measured in radians. 


asin returns the arcsine of x, in the range [-1/2,n/2]}. 
acos returns the arccosine of x, in the range [0,7]. 
atan returns the arctangent of x, in the range [—1/2,n/2]. 


atan2 returns the arctangent of y/x, in the range [-1,7], using the signs of 
both arguments to determine the quadrant of the return value. 


SEE ALSO 


matherr(3M) 


DIAGNOSTICS 
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sin, cos, and tan lose accuracy when their argument is far from zero. For 
arguments sufficiently large, these functions return zero when there would 
otherwise be a complete loss of significance. In this case a message indicating 
TLOSS error is printed on the standard error output. For less extreme argu- 
ments causing partial loss of significance, a PLOSS error is generated but no 
message is printed. In both cases, errno is set to ERANGE. 

If the magnitude of the argument of asin or acos is greater than one, or if 
both arguments of atan2 are zero, zero is returned and errno is set to EDOM. 
In addition, a message indicating DOMAIN error is printed on the standard 
error output. 

These error-handling procedures may be changed with the function math- 
err(3M). 


(3N) 


DYNIX/ptx T_ACCEPT(3N) 


NAME 


t_accept — accept a connect request 


SYNOPSIS 


#include <tiuser.h> 

int t_accept(fd, resfd, call) 
int fd; 

int resfd; 

struct t_call *call; 


DESCRIPTION 
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This function is issued by a transport user to accept a connect request. fd 
identifies the local transport endpoint where the connect indication arrived, 
resfd specifies the local transport endpoint where the connection is to be esta- 
blished, and call contains information required by the transport provider to 
complete the connection. call points to a t_call structure which contains the 
following members: 


struct netbuf addr; 
struct netbuf opt; 
struct netbuf udata; 
int sequence; 


netbuf is described in intro(3). In call, addr is the address of the caller, opt 
indicates any protocol-specific parameters associated with the connection, 
udata points to any user data to be returned to the caller, and sequence is 
the value returned by t_listen that uniquely associates the response with a 
previously received connect indication. Some transport providers may ignore 
the addr part of call. 


A transport user may accept a connection on either the same, or on a different, 
local transport endpoint than the one on which the connect indication arrived. 
If the same endpoint is specified (i.e., resfd=fd), the connection can be 
accepted unless the following condition is true: The user has received other 
indications on that endpoint but has not responded to them (with t_accept or 
t_snddis). For this condition, t_accept will fai] and set t_errno to TBADF. 


If a different transport endpoint is specified (resfd!=fd), the endpoint must be 
bound to a protocol address and must be in the T_IDLE state [see t_get- 
state(3N)] before the t_accept is issued. 

For both types of endpoints, t_accept wil] fail and set t_errno to TLOOK if 
there are indications (e.g., a connect or disconnect) waiting to be received on 
that endpoint. 

The values of parameters specified by opt and the syntax of those values are 
protocol specific. The udata argument enables the called transport user to 
send user data to the caller and the amount of user data must not exceed the 
limits supported by the transport provider as returned by t_open or 
t_getinfo. Ifthe len [see netbuf in intro(3)] field of udata is zero, no data 
will be sent to the caller. 


On failure, t_errno may be set to one of the following: 
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on the responding transport endpoint or use the specified 


[TACCES] The user does not have permission to accept a connection © 
options. 


endpoint referred to by resfd is not in the T_IDLE state. 


[TSYSERR] A system error has occurred during execution of this 
function. 
SEE ALSO 
intro(3), t_connect(3N), t_getstate(3N), t_listen(3N), t_open(3N), t_rcevcon- 
nect(3N) 
DIAGNOSTICS 


Upon successful completion, a value of 0 is returned. Otherwise, a value of —1 
is returned and t_errno is set to indicate the error. 
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NAME 


t_alloc — allocate a library structure 


SYNOPSIS 


#include <tiuser.h> 


char *t_alloc(fd, struct_type, fields) 
int fd; 

int struct_type; 

int fields; 


DESCRIPTION 
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The t_alloc function dynamically allocates memory for the various transport 
function argument structures as specified below. This function will allocate 
memory for the specified structure, and will also allocate memory for buffers 
referenced by the structure. 


The structure to allocate is specified by struct_type, and can be one of the fol- 
lowing: 


T_BIND struct t_bind 
T_CALL struct t_call 
T_OPTMGMT struct t_optmgmt 
T_DIS struct t_discon 


T_UNITDATA struct t_unitdata 
T_UDERROR struct t_uderr 
T_INFO struct t_info 


where each of these structures may subsequently be used as an argument to 
one or more transport functions. 


Each of the above structures, except T_INFO, contains at least one field of type 
struct netbuf. netbuf is described in intro(3). For each field of this type, 
the user may specify that the’ buffer for that field should be allocated as well. 
The fields argument specifies this option, where the argument is the bit- 
wise-OR of any of the following: 


T_ADDR The addr field of the t_bind, t_call, t_unitdata, or t_uderr struc- 
tures. 


T_OPT The opt field of the t_optmgmt, t_call, t_unitdata, or t_uderr 
structures. 


T_UDATA The udata field of the t_call, t_discon, or t_unitdata structures. 
T_ALL All relevant fields of the given structure. 


For each field specified in fields, t_alloc will allocate memory for the buffer 
associated with the field, and initialize the buf pointer and maxlen [see net- 
buf in intro(3) for description of buf and maxlen] field accordingly. The 
length of the buffer allocated will be based on the same size information that 
is returned to the user on t_open and t_getinfo. Thus, fd must refer to the 
transport endpoint through which the newly allocated structure will be pas- 
sed, so that the appropriate size information can be accessed. If the size value 
associated with any specified field is -1 or -2 (see t_open or t_getinfo), 
t_alloc will be unable to determine the size of the buffer to allocate and will 
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fail, setting t_errno to TSYSERR and errno to EINVAL. For any field not 
specified in fields, buf will be set to NULL and maxlen will be set to zero. 


Use of t_alloc to allocate structures will help ensure the compatibility of user 
programs with future releases of the transport interface. 


On failure, t_errno may be set to one of the following: 


{TBADF] The specified file descriptor does not refer to a transport end- 
point. 
[TSYSERR] A system error has occurred during execution of this function. 
SEE ALSO 
intro(3), t_free(3N), t_getinfo(3N), t_open(3N) 
DIAGNOSTICS 


On successful completion, t_alloc returns a pointer to the newly allocated 
structure. On failure, NULL is returned. 
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NAME 


t_bind — bind an address to a transport endpoint 


SYNOPSIS 


#include <tiuser.h> 


int t_bind(fd, req, ret) 
int fd; 

struct t_bind *req; 
struct t_bind ‘ret; 


DESCRIPTION 
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This function associates a protocol address with the transport endpoint speci- 
fied by fd and activates that transport endpoint. In connection mode, the 
transport provider may begin accepting or requesting connections on the 
transport endpoint. In connectionless mode, the transport user may send or 
receive data units through the transport endpoint. 


The req and ret arguments point to a t_bind structure containing the follow- 
ing members: 


struct netbuf addr; 
unsigned qlen; 


netbuf is described in intro(3). The addr field of the t_bind structure speci- 
fies a protocol address and the qlen field is used to indicate the maximum 
number of outstanding connect indications. 


req is used to request that an address, represented by the netbuf structure, 
be bound to the given transport endpoint. len [see netbuf in intro(3); also for 
buf and maxlen] specifies the number of bytes in the address and buf points 
to the address buffer. maxlen has no meaning for the req argument. On 
return, ret contains the address that the transport provider actually bound to 
the transport endpoint; this may be different from the address specified by the 
user in req. In ret, the user specifies maxlen which is the maximum size of 
the address buffer and buf which points to the buffer where the address is to 
be placed. On return, len specifies the number of bytes in the bound address 
and buf points to the bound address. If maxlen is not large enough to hold 
the returned address, an error results. 


If the requested address is not available, or if no address is specified in req 
(the len field of addr in req is zero) the transport provider assigns an appro- 
priate address to be bound, and returns that address in the addr field of ret. 
The user can compare the addresses in req and ret to determine whether the 
transport provider bound the transport endpoint to a different address than 
that requested. 

req may be NULL if the user does not wish to specify an address to be bound. 
Here, the value of glen is assumed to be zero, and the transport provider must 
assign an address to the transport endpoint. Similarly, ret may be NULL if 
the user does not care what address was bound by the provider and is not 
interested in the negotiated value of qlen. It is valid to set req and ret to 
NULL for the same call, in which case the provider chooses the address to 
bind to the transport endpoint and does not return that information to the 


user. 
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The qlen field has meaning only when initializing a connection-mode service. 
It specifies the number of outstanding connect indications the transport pro- 
vider should support for the given transport endpoint. An outstanding con- 
nect indication is one that has been passed to the transport user by the trans- 
port provider. A value of qlen greater than zero is only meaningful when 
issued by a passive transport user that expects other users to call it. The 
value of qlen is negotiated by the transport provider and may be changed if 
the transport provider cannot support the specified number of outstanding 
connect indications. On return, the glen field in ret contains the negotiated 
value. 


This function allows more than one transport endpoint to be bound to the 
same protocol address (however, the transport provider must support this 
capability also), but it is not allowable to bind more than one protocol address 
to the same transport endpoint. If a user binds more than one transport end- 
point to the same protocol address, only one endpoint can be used to listen for 
connect indications associated with that protocol address. In other words, 
only one t_bind for a given protocol address may specify a value of qlen 
greater than zero. In this way, the transport provider can identify which 
transport endpoint should be notified of an incoming connect indication. Ifa 
user attempts to bind a protocol address to a second transport endpoint with a 
value of qlen greater than zero, the transport provider assigns another 
address to be bound to that endpoint. Ifa user accepts a connection on the 
transport endpoint that is being used as the listening endpoint, the bound pro- 
tocol address is found to be busy for the duration of that connection. No other 
transport endpoints may be bound for listening while that initial listening 
endpoint is in the data transfer phase. This prevents more than one transport 
endpoint bound to the same protocol address from accepting connect indica- 
tions. 


On failure, t_errno may be set to one of the following: 


[TACCES] The user does not have permission to use the specified 
address. 

[TBADADDR] The specified protocol address was in an incorrect format 
or contained illegal information. 

[TBADF] The specified file descriptor does not refer to a transport 
endpoint. 

[TBUFOVFLW] The number of bytes allowed for an incoming argument is 


not sufficient to store the value of that argument. The 
provider’s state changes to T_IDLE and the information to 
be returned in ret is discarded. 


[TNOADDR] The transport provider could not allocate an address. 

(TOUTSTATE] The function was issued in the wrong sequence. 

(TSYSERR] Asystem error has occurred during execution of this 
function. 
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SEE ALSO 
intro(3), t_open(3N), t_optmgmt(3N), t_unbind(3N) 


DIAGNOSTICS 
t_bind returns 0 on success and -1 on failure and t_errno is set to indicate 
the error. 
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NAME 
t_close — close a transport endpoint 


SYNOPSIS 
#include <tiuser.h> 
int t_close(fd) 
int fd; 

DESCRIPTION 
The t_close function informs the transport provider that the user is finished 
with the transport endpoint specified by fd, and frees any local library 
resources associated with the endpoint. In addition, t_close closes the file 
associated with the transport endpoint. 
t_close should be called from the T.UNBND state [see t_getstate(3N)]. How- 
ever, this function does not check state information, so it may be called from 
any state to close a transport endpoint. If this occurs, the local library 
resources associated with the endpoint are freed automatically. In addition, 
close(2) is issued for that file descriptor; the close is abortive if no other pro- 
cess has that file open, and breaks any transport connection that may be asso- 
ciated with that endpoint. 
On failure, t_errno may be set to the following: 


[TBADF] The specified file descriptor does not refer to a transport end- 
point. 


SEE ALSO 
t_getstate(3N), t_open(3N), t_unbind(3N) 


DIAGNOSTICS 
t_close returns 0 on success and -1 on failure and t_errno is set to indicate 
the error. 
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NAME 


t_connect — establish a connection with another transport user 


SYNOPSIS 


#include <tiuser.h> 


int t_connect(fd, sndcall, revcall) 
int fd; 

struct t_call *sndcall; 

struct t_call *revcall; 


DESCRIPTION 
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This function enables a transport user to request a connection to the specified 
destination transport user. fd identifies the local transport endpoint where 
communication is established, while sndcall and revcall point to a t_call 
structure which contains the following members: 


struct netbuf addr; 
struct netbuf opt; 
struct netbuf udata; 
int sequence; 


sndcall specifies information needed by the transport provider to establish a 
connection and reveall specifies information that is associated with the newly 
established connection. 


Netbuf is described in intro(3). In sndeall, addr specifies the protocol 
address of the destination transport user, opt presents any protocol-specific 
information that might be needed by the transport provider, udata points to 
optional user data that may be passed to the destination transport user dur- 
ing connection establishment, and sequence has no meaning for this func- 
tion. 


On return in reveall, addr returns the protocol address associated with the 
responding transport endpoint, opt presents any protocol-specific information 
associated with the connection, udata points to optional user data that may 
be returned by the destination transport user during connection establish- 
ment, and sequence has no meaning for this function. 


The opt argument implies no structure on the options that may be passed to 
the transport provider. The transport provider is free to specify the structure 
of any options passed to it. These options are specific to the underlying proto- 
col of the transport provider. The user may choose not to negotiate protocol 
options by setting the len field of opt to zero. In this case, the provider may 
use default options. 


The udata argument enables the caller to pass user data to the destination 
transport user and receive user data from the destination user during connec- 
tion establishment. However, the amount of user data must not exceed the 
limits supported by the transport provider as returned by t_open (3N) or 
t_getinfo (3N). If the len [see netbuf in intro(3)] field of udata is zero in 
sndcall, no data is sent to the destination transport user. 


On return, the addr, opt, and udata fields of revcall is updated to reflect 
values associated with the connection. Thus, the maxlen [see netbuf in 
intro(3)] field of each argument must be set before issuing this function to 


T_CONNECT(3N) DYNIX/ptx 


indicate the maximum size of the buffer for each. However, reveall may be 
NULL, in which case no information is given to the user on return from 
t_connect. 


By default, t_connect executes in synchronous mode, and waits for the desti- 
nation user’s response before returning control to the local user. A successful 
return (i.e. return value of zero) indicates that the requested connection has 
been established. However, if O_NDELAY is set (via t_open or fentl), t_con- 
nect executes in asynchronous mode. In this case, the call will not wait for 
the remote user’s response, but returns control immediately to the local user 
and return -1 with t_errno set to TNODATA to indicate that the connection 
has not yet been established. In this way, the function simply initiates the 
connection establishment procedure by sending a connect request to the desti- 
nation transport user. 


On failure, t_errno may be set to one of the following: 


(TACCES] The user does not have permission to use the specified 
address or options. 

(TBADADDR] The specified protocol address was in an incorrect format 
or contained illegal information. 

(TBADDATA] The amount of user data specified was not within the 
bounds allowed by the transport provider. 

(TBADF] The specified file descriptor does not refer to a transport 
endpoint. 

[TBADOPT] The specified protocol options were in an incorrect format 
or contained illegal information. 

[TBUFOVFLW] The number of bytes allocated for an incoming argument 


is not sufficient to store the value of that argument. If 
executed in synchronous mode, the provider’s state, as 
seen by the user, changes to TDATAXFER, and the con- 
nect indication information to be returned in reveall is 


discarded. 

[TLOOK] An asynchronous event has occurred on this transport 
endpoint and requires immediate attention. 

(TNODATA] O_NDELAY was set, so the function successfully initiated 


the connection establishment procedure, but did not wait 
for a response from the remote user. 


[TNOTSUPPORT] This function is not supported by the underlying trans- 


port provider. 
[TOUTSTATE] The function was issued in the wrong sequence. 
[TSYSERR] A system error has occurred during execution of this 
function. 


SEE ALSO 
intro(3), t_accept(3N), t_getinfo(3N), t_listen(3N), t_open(3N), t_optmgmt(3N), 
t_revconnect(3N) 

DIAGNOSTICS 
t_connect returns 0 on success and -1 on failure and t_errno is set. 
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NAME 


t_error — produce error message 


SYNOPSIS 


#include <tiuser.h> 


void t_error(errmsg) 
char *errmsg; 

extern int t_errno; 
extern char *t_errlist[]; 
extern int t_nerr; 


DESCRIPTION 


t_error produces a message on the standard error output which describes the 
last error encountered during a call to a transport function. The argument 
string errmsg is a user-supplied error message that gives context to the error. 


t_error prints the user-supplied error message followed by a colon, and the 
standard transport function error message for the current value contained in 
t_errno. If t_errno is TSYSERR, t_error also prints the standard error 
message for the current value contained in errno [see intro(2)]. 


t_errlist is the array of message strings, to allow user-message formatting. 
t_errno can be used as an index into this array to retrieve the error message 
string (without a terminating newline). t_nerr is the maximum index value 
for the t_errlist array. 


t_errno is set when an error occurs and is not cleared on subsequent success- 
ful calls. 


EXAMPLES 
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If a t_connect function fails on transport endpoint fd2 because a bad address 
was given, the following call might follow the failure: 


t_error("t_connect failed on fd2"); 
The diagnostic message would print as: 


t_connect failed on fd2: Incorrect transport address for- 
mat 


where t_connect failed on fd2 tells the user which function failed on 
which transport endpoint, and Incorrect transport address format 
identifies the specific error that occurred. 
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NAME 
t_free — free a library structure 


SYNOPSIS 
#include <tiuser.h> 
int t_free(ptr, struct_type) 
char *ptr; 
int struct_type; 
DESCRIPTION 
The t_free function frees memory previously allocated by t_alloc. This func- 
tion will free memory for the specified structure, and will also free memory for 
buffers referenced by the structure. 


ptr points to one of the six structure types described for t_alloc, and 
struct_type identifies the type of that structure which can be one of the fol- 


lowing: 

T_BIND struct t_bind 
T_CALL struct t_call 
T_OPTMGMT struct t_optmgmt 
T_DIS struct t_discon 


T_UNITDATA struct t_unitdata 
T_UDERROR struct t_uderr 


T_INFO struct t_info 
where each of these structures is used as an argument to one or more trans- 
port functions. 


t_free will check the addr, opt, and udata fields of the given structure (as 
appropriate), and free the buffers pointed to by the buf field of the netbuf [see 
intro(3)] structure. If buf is NULL, t_free will not attempt to free memory. 
After all buffers are freed, t_free will free the memory associated with the 
structure pointed to by ptr. 


Undefined results will occur if ptr or any of the buf pointers points to a block 
of memory that was not previously allocated by t_alloc. 


On failure, t_errno may be set to the following: 
[TSYSERR] Asystem error has occurred during execution of this function. 


SEE ALSO 
intro(3), t_alloc(3N) 


DIAGNOSTICS 
t_free returns 0 on success and -1 on failure and t_errno is set to indicate the 


error. 
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NAME 
t_getinfo — get protocol-specific service information 
SYNOPSIS 
#include <tiuser.h> 
int t_getinfo(fd, info) 
int fd; 
struct t_info *info; 
DESCRIPTION 
This function returns the current characteristics of the underlying The info 
structure is used to return the same information returned by t_open. This 
function enables a transport user to access this information during any phase 


of communication. 

This argument points to a t_info structure which contains the following mem- 

bers: 

long addr; /* max size of transport protocol address */ 

long options; /* max number of bytes of protocol-specific options */ 
long tsdu; /* max size transport service data unit (TSDU) */ 


long etsdu; /* max size expedited transport service data unit */ 
long connect; /* max data allowed on connection estab functions */ 
long discon; /* max data allowed on t_snddis and t_revdis functions * 
long servtype;/* service type supported by the transport provider */ 


The values of the fields have the following meanings: 


addr A value greater than or equal to zero indicates the maximum 
size of a transport protocol address; a value of -1 specifies that 
there is no limit on the address size; and a value of -2 specifies 
that the transport provider does not provide user access to 
transport protocol addresses. 


options A value greater than or equal to zero indicates the maximum 
number of bytes of protocol-specific options supported by the 
provider; a value of -1 specifies that there is no limit on the 
option size; and a value of -2 specifies that the transport pro- 
vider does not support user-settable options. 


tsdu A value greater than zero specifies the maximum size of a 
transport service data unit (TSDU); a value of zero specifies 
that the transport provider does not support the concept of 
TSDU, although it does support the sending of a data stream 
with no logical boundaries preserved across a connection; a 
value of -1 specifies that there is no limit on the size ofa 
TSDU; and a value of -2 specifies that the transfer of normal 
data is not supported by the transport provider. 


etsdu A value greater than zero specifies the maximum size of an 
expedited transport service data unit ETSDU); a value of zero 
specifies that the transport provider does not support the con- 
cept of ETSDU, although it does support the sending of an 
expedited data stream with no logical boundaries preserved 
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connect 


discon 


servtype 
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across a connection; a value of -1 specifies that there is no limit 
on the size of an ETSDU; and a value of -2 specifies that the 
transfer of expedited data is not supported by the transport 
provider. 


A value greater than or equal to zero specifies the maximum 
amount of data that may be associated with connection estab- 
lishment functions; a value of -1 specifies that there is no limit 
on the amount of data sent during connection establishment; 
and a value of -2 specifies that the transport provider does not 
allow data to be sent with connection establishment functions. 


A value greater than or equal to zero specifies the maximum 
amount of data that may be associated with the t_snddis and 
t_revdis functions; a value of -1 specifies that there is no limit 
on the amount of data sent with these abortive release func- 
tions; and a value of -2 specifies that the transport provider 
does not allow data to be sent with the abortive release func- 
tions. 


This field specifies the service type supported by the transport 
provider, as described below. 


If a transport user is concerned with protocol independence, the above sizes 
may be accessed to determine how large the buffers must be to hold each piece 


of information. 


Alternatively, the t_alloc function may be used to allocate 


these buffers. An error results if a transport user exceeds the allowed data 
size on any function. The value of each field may change as a result of option 
negotiation, and t_getinfo enables a user to retrieve the current characteris- 


tics. 
DIAGNOSTICS 


If successful, t_getinfo returns a 0. Otherwise —1 is returned, and errno is 


set to indicate 


the error. 


The servtype field of info may specify one of the following values on return: 


T_COTS 
T_COTS_ORD 


T_CLTS 


ERRORS 


The transport provider supports a connection-mode service 
but does not support the optional orderly release facility. 


The transport provider supports a connection-mode service 
with the optional orderly release facility. 


The transport provider supports a connectionless-mode ser- 
vice. For this service type, t_open returns -2 for etsdu, con- 
nect, and discon. 


On failure, t_errno may be set to one of the following: 


(TBADF] 


(TSYSERR] 


SEE ALSO 
t_open(3N) 


The specified file descriptor does not refer to a transport end- 
point. 
A system error has occurred during execution of this function. 
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NAME 
t_getstate — get the current state 


SYNOPSIS 
#include <tiuser.h> 
int t_getstate(fd) 
int fd; 
DESCRIPTION 
The t_getstate function returns the current state of the provider associated 
with the transport endpoint specified by fd. 


On failure, t_errno may be set to one of the following: 


(TBADF] The specified file descriptor does not refer to a transport 
endpoint. 
[TSTATECHNG] The transport provider is undergoing a state change. 
[TSYSERR] A system error has occurred during execution of this func- 
tion. 
SEE ALSO 
t_open(3N) 
DIAGNOSTICS 


t_getstate returns the current state on successful completion and -1 on fail- 
ure and t_errno is set to indicate the error. The current state may be one of 


the following: 

T_UNBND unbound 

T_IDLE idle 

T_OUTCON outgoing connection pending 
T_INCON incoming connection pending 


T_DATAXFER data transfer 


T_OUTREL outgoing orderly release (waiting for an orderly release indi- 
cation) 

T_INREL incoming orderly release (waiting for an orderly release 
request) 

If the provider is undergoing a state transition when t_getstate is called, the 

function fails. 
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NAME 


t_listen — listen for a connect request 


SYNOPSIS 


#include <tiuser.h> 
int t_listen(fd, call) 
int fd; 

struct t_call *call; 


DESCRIPTION 
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This function listens for a connect request from a calling transport user. fd 
identifies the local transport endpoint where connect indications arrive, and 
on return, call contains information describing the connect indication. call 
points to a t_call structure which contains the following members: 


struct netbuf addr; 
struct netbuf opt; 
struct netbuf udata; 
int sequence; 


netbuf is described in intro(3). In call, addr returns the protocol address of 
the calling transport user, opt returns protocol-specific parameters associated 
with the connect request, udata returns any user data sent by the caller on 
the connect request, and sequence is a number that uniquely identifies the 
returned connect indication. The value of sequence enables the user to listen 
for multiple connect indications before responding to any of them. 


Since this function returns values for the addr, opt, and udata fields of call, 
the maxlen [see netbuf in intro(3)] field of each must be set before issuing 
the t_listen to indicate the maximum size of the buffer for each. 


By default, t_listen executes in synchronous mode and waits for a connect 
indication to arrive before returning to the user. However, if O_NDELAY is 
set (via t_open or fentl), t_listen executes asynchronously, reducing to a poll 
for existing connect indications. If none are available, it returns -1 and sets 
t_errno to TNODATA. 


On failure, t_errno may be set to one of the following: 


[TBADF] The specified file descriptor does not refer to a transport 
endpoint. 
[TBUFOVFLW] The number of bytes allocated for an incoming argu- 


ment is not sufficient to store the value of that argu- 
ment. The provider’s state, as seen by the user, changes 
to T_INCON, and the connect indication information to 
be returned in call is discarded. 


([TLOOK] An asynchronous event has occurred on this transport 
endpoint and requires immediate attention. 

[TNODATA] O_NDELAY was set, but no connect indications had been 
queued. 


[TNOTSUPPORT] This function is not supported by the underlying trans- 
port provider. 
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[TSYSERR] Asystem error has occurred during execution of this 
function. 

WARNINGS 
If a user issues t_listen in synchronous mode on a transport endpoint that 
was not bound for listening (i.e. qlen was zero on t_bind), the call waits for- 
ever because no connect indications arrive on that endpoint. 

SEE ALSO 
intro(3), t_accept(3N), t_bind(3N), t_connect(3N), t_open(3N), t_revcon- 
nect(3N) 

DIAGNOSTICS 


t_listen returns 0 on success and -1 on failure and t_errno is set to indicate 
the error. 
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NAME 


t_look — look at the current event on a transport endpoint 


SYNOPSIS 
#include <tiuser.h> 


int t_look(fd) 
int fd; 


DESCRIPTION 
This function returns the current event on the transport endpoint specified by 
fd. This function enables a transport provider to notify a transport user of an 
asynchronous event when the user is issuing functions in synchronous mode. 
Certain events require immediate notification of the user and are indicated by 
a specific error, TLOOK, on the current or next function to be executed. 
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This function also enables a transport user to poll a transport endpoint period- 


ically for asynchronous events. 

On failure, t_errno may be set to one of the following: 

{TBADF] The specified file descriptor does not refer to a transport end- 

point. 

[TSYSERR] A system error has occurred during execution of this function. 
SEE ALSO 

t_open(3N) 
DIAGNOSTICS 
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Upon success, t_look returns a value that indicates which of the allowable 
events has occurred, or returns zero if no event exists. One of the following 


events is returned: 
T_CONNECT 
T_DATA 
T_DISCONNECT 
T_ERROR 
T_EXDATA 
T_LISTEN 
T_ORDREL 
T_UDERR 


connect confirmation received 
normal data received 
disconnect received 

fatal error indication 
expedited data received 
connection indication received 
orderly release indication 
datagram error indication 


On failure, -1 is returned and t_errno is set to indicate the error. 
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NAME 


t_open — establish a transport endpoint 


SYNOPSIS 


#include <tiuser.h> 


int t_open(path, oflag, info) 
char *path; 

int oflag; 

struct t_info *info; 


DESCRIPTION 
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t_open must be called as the first step in the initialization of a transport end- 
point. This function establishes a transport endpoint by opening a file that 
identifies a particular transport provider (i.e. transport protocol) and return- 
ing a file descriptor that identifies that endpoint. 


path points to the pathname of the file to open, and oflag identifies any open 
flags [as in open(2)]. t_open returns a file descriptor that is used by all sub- 
sequent functions to identify the particular local transport endpoint. 


This function also returns various default characteristics of the underlying 
transport protocol by setting fields in the t_info structure. This argument 
points to a t_info which contains the following members: 


long addr; /* max size of the transport protocol address */ 

long options; /* max number of bytes of protocol-specific options */ 

long tsdu; /* max size of a transport service data unit (TSDU) */ 

long etsdu; /* max size of an expedited transport service data 
unit (ETSDU) */ 

long connect; /* max amount of data allowed on connection 
establishment functions */ 

long discon; /* max amount of data allowed on t_snddis and 
t_revdis functions */ 

long servtype; /* service type supported by the transport provider */ 


The values of the fields have the following meanings: 


addr A value greater than or equal to zero indicates the maximum 
size of a transport protocol address; a value of -1 specifies that 
there is no limit on the address size; and a value of -2 specifies 
that the transport provider does not provide user access to 
transport protocol addresses. 


options A value greater than or equal to zero indicates the maximum 
number of bytes of protocol-specific options supported by the 
provider; a value of -1 specifies that there is no limit on the 
option size; and a value of -2 specifies that the transport pro- 
vider does not support user-settable options. 


‘tsdu A value greater than zero specifies the maximum size of a 


transport service data unit (TSDU); a value of zero specifies 
that the transport provider does not support the concept of 
TSDU, although it does support the sending of a data stream 
with no logical boundaries preserved across a connection; a 
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value of -1 specifies that there is no limit on the size of a TSDU; 
and a value of -2 specifies that the transfer of normal data is 
not supported by the transport provider. 


etsdu A value greater than zero specifies the maximum size of an 
expedited transport service data unit (ETSDU); a value of zero 
specifies that the transport provider does not support the con- 
cept of ETSDU, although it does support the sending of an 
expedited data stream with no logical boundaries preserved 
across a connection; a value of -1 specifies that there is no limit 
on the size of an ETSDU; and a value of -2 specifies that the 
transfer of expedited data is not supported by the transport 
provider. 


connect A value greater than or equal to zero specifies the maximum 
amount of data that may be associated with connection estab- 
lishment functions; a value of -1 specifies that there is no limit 
on the amount of data sent during connection establishment; 
and a value of -2 specifies that the transport provider does not 
allow data to be sent with connection establishment functions. 


discon A value greater than or equal to zero specifies the maximum — 
amount of data that may be associated with the t_snddis and 
t_revdis functions; a value of -1 specifies that there is no limit 
on the amount of data sent with these abortive release func- 
tions; and a value of -2 specifies that the transport provider 
does not allow data to be sent with the abortive release func- 
tions. 


servtype This field specifies the service type supported by the transport 
provider, as described below. 


If a transport user is concerned with protocol independence, the above sizes 
may be accessed to determine how large the buffers must be to hold each piece 
of information. Alternatively, the t_alloc function may be used to allocate 
these buffers. An error results if a transport user exceeds the allowed data 
size on any function. 


The servtype field of info may specify one of the following values on return: 


T_CLTS The transport provider supports a connectionless-mode service. 
For this service type, t_open returns -2 for etsdu, connect, 
and discon. 

T_COTS The transport provider supports a connection-mode service but 


does not support the optional orderly release facility. 


T_COTS_ORD The transport provider supports a connection-mode service 
with the optional orderly release facility. 

Asingle transport endpoint may support only one of the above services at one 

time. 

If info is set to NULL by the transport user, no protocol information is 

returned by t_open. 


On failure, t_errno may be set to the following: 
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(TSYSERR] Asystem error has occurred during execution of this 
function. 
SEE ALSO 
open(2) 
DIAGNOSTICS 


t_open returns a valid file descriptor on success and -1 on failure and t_errno 
is set to indicate the error. 
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NAME 
t_optmgmt — manage options for a transport endpoint 


SYNOPSIS 
#include <tiuser.h> 


int t_optmgmt(fd, req, ret) 
int fd; 
struct t_optmgmt *req; 
struct t_optmgmt ‘ret; 
DESCRIPTION 
The t_optmgmt function enables a transport user to retrieve, verify, or nego- 
tiate protocol options with the transport provider. fd identifies a bound trans- 
port endpoint. 


The req and ret arguments point to a t_optmgmt structure containing the 
following members: 


struct netbuf opt; 
long flags; 


The opt field identifies protocol options and the flags field is used to specify 
the action to take with those options. 


The options are represented by a netbuf [see intro(3); also for len, buf and 
maxlen] structure in a manner similar to the address in t_bind. req is used 
to request a specific action of the provider and to send options to the provider. 
len specifies the number of bytes in the options, buf points to the options buf- 
fer, and maxlen has no meaning for the req argument. The transport pro- 
vider may return options and flag values to the user through ret. For ret, 
maxlen specifies the maximum size of the options buffer and buf points to the 
buffer where the options are to be placed. On return, len specifies the number 
of bytes of options returned. maxlen has no meaning for the req argument, 
but must be set in the ret argument to specify the maximum number of bytes 
the options buffer can hold. The actual structure and content of the options is 
imposed by the transport provider. 


The flags field of req can specify one of the following actions: 


T_CHECK This action enables the user to verify whether the options 
specified in req are supported by the transport provider. On 
return, the flags field of ret has either TSSUCCESS or T_FAIL- 
URE set to indicate to the user whether the options are sup- 
ported. These flags are only meaningful for the T.CHECK 
request. 

T_DEFAULT This action enables a user to retrieve the default options sup- 
ported by the transport provider into the opt field of ret. In 
req, the len field of opt must be zero and the buf field may 
be NULL. 

T NEGOTIATE This action enables the user to negotiate the values of the 
options specified in req with the transport provider. The pro- 
vider evaluates the requested options and negotiates the val- 
ues, returning the negotiated values through ret. 
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If issued as part of the connectionless-mode service, 
t_optmgmt may block due to flow control constraints. The function is 
not complete until the transport provider has processed all previously 


sent data units. 

On failure, t_errno may be set to one of the following: 

(TACCES] The user does not have permission to negotiate the 
specified options. 

(TBADF] The specified file descriptor does not refer to a transport 
endpoint. 

[TBADFLAG] An invalid flag was specified. 

[TBADOPT] The specified protocol options were in an incorrect for- 
mat or contained illegal information. 

[TBUFOVFLW] The number of bytes allowed for an incoming argument 


is not sufficient to store the value of that argument. The 
information to be returned in ret is discarded. 


[TOUTSTATE] The function was issued in the wrong sequence. 
[TSYSERR] A system error has occurred during execution of this 
function. 
SEE ALSO 
intro(3), t_getinfo(3N), t_open(3N) 
DIAGNOSTICS 


t_optmgmt returns 0 on success and -1 on failure and t_errno is set to indi- 
cate the error. 
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NAME 


t_rcv — receive data or expedited data sent over a connection 


SYNOPSIS 


int t_rev(fd, buf, nbytes, flags) 
int fd; 

char *buf; 

unsigned nbytes; 

int *flags; 


DESCRIPTION 
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This function receives either normal or expedited data. fd identifies the local 
transport endpoint through which data will arrive, buf points to a receive buf- 
fer where user data will be placed, and nbytes specifies the size of the receive 
buffer. flags may be set on return from t_rev and specifies optional flags as 
described below. 


By default, t_rev operates in synchronous mode and waits for data to arrive if 
none is currently available. However, if O_.NDELAY is set (via t_open or 
fentl), t_rev executes in asynchronous mode and fails if no data is available. 
(See TNODATA below.) 


On return from the call, if T.MORE is set in flags this indicates that there is 
more data and the current transport service data unit (TSDU) or expedited 
transport service data unit (ETSDU) must be received in multiple t_rev calls. 
Each t_rev with the T.MORE flag set indicates that another t_rev must fol- 
low immediately to get more data for the current TSDU The end of the TSDU 
is identified by the return of a t_rev call with the T.MORE flag not set. If the 
transport provider does not support the concept of a TSDU as indicated in the 
info argument on return from t_open or t_getinfo, the T.MORE flag is not 
meaningful and should be ignored. 


On return, the data returned is expedited data if TEXPEDITED is set in flags. 
If the number of bytes of expedited data exceeds nbytes, t_rcv is set 
T_EXPEDITED and T_MORE on return from the initial call. Subsequent calls to 
retrieve the remaining ETSDU will not have T_EXPEDITED set on return. The 
end of the ETSDU is identified by the return of a t_rev call with the T MORE 
flag not set. 

If expedited data arrives after part of a TSDU has been retrieved, receipt of the 
remainder of the TSDU is suspended until the ETSDU has been processed. 
Only after the full ETSDU has been retrieved (T_MORE not set) is the remain- 
der of the TSDU be available to the user. 


On failure, t_errno may be set to one of the following: 


{TBADF] The specified file descriptor does not refer to a transport 
endpoint. 
(TLOOK] An asynchronous event has occurred on this transport 


endpoint and requires immediate attention. 


[TNODATA] O_NDELAY was set, but no data is currently available 
from the transport provider. 


[TNOTSUPPORT] This function is not supported by the underlying trans- 
port provider. 
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(TSYSERR] A system error has occurred during execution of this 
function. 
SEE ALSO 
t_open(3N), t_snd(3N) 
DIAGNOSTICS 


On successful completion, t_rev returns the number of bytes received; on fail- 


ure it returns -1 and t_errno is set to indicate the error. 
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NAME 


t_revconnect — receive the confirmation from a connect request 


SYNOPSIS 


#include <tiuser.h> 

int t_revconnect(fd, call) 
int fd; 

struct t_call *call; 


DESCRIPTION 
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This function enables a calling transport user to determine the status of a pre- 
viously sent connect request and is used in conjunction with t_connect to 
establish a connection in asynchronous mode. The connection is established 
on successful completion of this function. 


fd identifies the local transport endpoint where communication will be esta- 
blished, and call contains information associated with the newly established 
connection. call points to a t_call structure which contains the following 
members: 


struct netbuf addr; 
struct netbuf opt; 
struct netbuf udata; 
int sequence; 


netbuf is described in intro(3). In call, addr returns the protocol address 
associated with the responding transport endpoint, opt presents any protocol- 
specific information associated with the connection, udata points to optional 
user data that may be returned by the destination transport user during con- 
nection establishment, and sequence has no meaning for this function. 


The maxlen [see netbuf in intro(3)] field of each argument must be set 
before issuing this function to indicate the maximum size of the buffer for 
each. However, call may be NULL, in which case no information is given to 
the user on return from t_revconnect. By default, t_revconnect executes in 
synchronous mode and waits for the connection to be established before 
returning. On return, the addr, opt, and udata fields reflect values associ- 
ated with the connection. 

If O_NDELAY is set (via t_open or fentl), t_rcvconnect executes in asynchro- 
nous mode, and reduces to a poll for existing connect confirmations. If none 
are available, t_revconnect fails and returns immediately without waiting 
for the connection to be established. (See TNODATA below.) t_revconnect 
must be re-issued at a later time to complete the connection establishment 
phase and retrieve the information returned in call. 


On failure, t_errno may be set to one of the following: 


[TBADF] The specified file descriptor does not refer to a transport 
endpoint. 
[TBUFOVFLW] The number of bytes allocated for an incoming argu- 


ment is not sufficient to store the value of that argu- 
ment and the connect information to be returned in call 
is discarded. The provider’s state, as seen by the user, is 
changed to DATAXFER. 
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[TLOOK] An asynchronous event has occurred on this transport 
connection and requires immediate attention. 
(TNODATA] O_NDELAY was set, but a connect confirmation has not 
yet arrived. 
[TNOTSUPPORT] This function is not supported by the underlying trans- 
port provider. 
[TSYSERR] A system error has occurred during execution of this 
function. 
SEE ALSO 
intro(3), t_accept(3N), t_bind(3N), t_connect(3N), t_listen(3N), t_open(3N) 
DIAGNOSTICS 


t_revconnect returns 0 on success and -1 on failure and t_errno is set to 
indicate the error. 
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NAME 


t_revdis — retrieve information from disconnect 


SYNOPSIS 


#include <tiuser.h> 
t_revdis(fd, discon) 

int fd; 

struct t_discon *discon; 


DESCRIPTION 
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This function is used to identify the cause of a disconnect, and to retrieve any 
user data sent with the disconnect. fd identifies the local transport endpoint 
where the connection existed, and discon points to a t_discon structure con- 
taining the following members: 


struct netbuf udata; 
int reason; 
int sequence; 


netbuf is described in intro(3). reason specifies the reason for the discon- 
nect through a protocol-dependent reason code, udata identifies any user data 
that was sent with the disconnect, and sequence may identify an outstanding 
connect indication with which the disconnect is associated. sequence is only 
meaningful when t_revdis is issued by a passive transport user who has exe- 
cuted one or more t_listen functions and is processing the resulting connect 
indications. Ifa disconnect indication occurs, sequence can be used to iden- 
tify which of the outstanding connect indications is associated with the discon- 
nect. 


If a user does not care if there is incoming data and does not need to know the 
value of reason or sequence, discon may be NULL and any user data asso- 
ciated with the disconnect will be discarded. However, if a user has retrieved 
more than one outstanding connect indication (via t_listen) and discon is 
NULL, the user will be unable to identify with which connect indication the 
disconnect is associated. 


On failure, t_errno may be set to one of the following: 


(TBADF] The specified file descriptor does not refer to a transport 
endpoint. 

(TNODIS] No disconnect indication currently exists on the speci- 
fied transport endpoint. 

[TBUFOVFLW] The number of bytes allocated for incoming data is not 


sufficient to store the data. The provider’s state, as seen 
by the user, will change to T_IDLE, and the disconnect 
indication information to be returned in discon will be 


discarded. 

(TNOTSUPPORT] This function is not supported by the underlying trans- 
port provider. 

[TSYSERR] A system error has occurred during execution of this 
function. 
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SEE ALSO 
intro(3), t_connect(3N), t_listen(3N), t_open(3N), t_snddis(3N) @ 


DIAGNOSTICS 
t_revdis returns 0 on success and -1 on failure and t_errno is set to indicate 
the error. 
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NAME 

t_revrel — acknowledge receipt of an orderly release indication 
SYNOPSIS 

#include <tiuser.h> 

t_revrel(fd) 

int fd; 
DESCRIPTION 


This function is used to acknowledge receipt of an orderly release indication. 
fd identifies the local transport endpoint where the connection exists. After 
receipt of this indication, the user may not attempt to receive more data 
because such an attempt blocks forever. However, the user may continue to 
send data over the connection if t_sndrel has not been issued by the user. 


This function is an optional service of the transport provider, and is only sup- 
ported if the transport provider returned service type T.COTS_ORD on t_open 


or t_getinfo. 
On failure, t_errno may be set to one of the following: 
(TBADF] The specified file descriptor does not refer to a transport 
endpoint. 
(TLOOK] An asynchronous event has occurred on this transport 
endpoint and requires immediate attention. 
[TNOREL] No orderly release indication currently exists on the 
specified transport endpoint. 
[TNOTSUPPORT] This function is not supported by the underlying trans- 
port provider. 
[TSYSERR] A system error has occurred during execution of this 
function. 
SEE ALSO 
t_open(3N), t_sndrel(3N) 
DIAGNOSTICS 
t_revrel returns 0 on success, and -1 on failure t_errno is set to indicate the 
error. 
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NAME 


t_rcvudata — receive a data unit 


SYNOPSIS 


#include <tiuser.h> 


int t_revudata(fd, unitdata, flags) 
int fd; 

struct t_unitdata *unitdata; 

int *flags; 


DESCRIPTION 
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This function is used in connectionless mode to receive a data unit from 
another transport user. fd identifies the local transport endpoint through 
which data will be received, unitdata holds information associated with the 
received data unit, and flags is set on return to indicate that the complete 
data unit was not received. unitdata points to a t_unitdata structure con- 
taining the following members: 


struct netbuf addr; 
struct netbuf opt; 
struct netbuf udata; 


The maxlen [see netbuf in intro(3)] field of addr, opt, and udata must be 
set before issuing this function to indicate the maximum size of the buffer for 
each. 


On return from this call, addr specifies the protocol address of the sending 
user, opt identifies protocol-specific options that were associated with this 
data unit, and udata specifies the user data that was received. 


By default, t_revudata operates in synchronous mode and waits for a data 
unit to arrive if none is currently available. However, if O_NDELAY is set (via 
t_open or fentl), t_rcvudata executes in asynchronous mode and fails if no 
data units are available. 


If the buffer defined in the udata field of unitdata is not large enough to hold 
the current data unit, the buffer is filled and T.MORE is set in flags on 
return to indicate that another t_revudata should be issued to retrieve the 
rest of the data unit. Subsequent t_revudata call(s) return zero for the 
length of the address and options until the full data unit has been received. 


On failure, t_errno may be set to one of the following: 


[TBADF] The specified file descriptor does not refer to a transport 
endpoint. 
[TBUFOVFLW] The number of bytes allocated for the incoming protocol 


address or options is not sufficient to store the informa- 
tion. The unit data information to be returned in unit- 
data is discarded. 


[TLOOK] An asynchronous event has occurred on this transport 
endpoint and requires immediate attention. 


[TNODATA] O_NDELAY was set, but no data units are currently 
available from the transport provider. 
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([TNOTSUPPORT] This function is not supported by the underlying trans- 
port provider. @ 
[TSYSERR] A system error has occurred during execution of this 
function. 
SEE ALSO 
intro(3), t_revuderr(3N), t_sndudata(3N) 
DIAGNOSTICS 


t_revudata returns 0 on successful completion and -1 on failure and t_errno 
is set to indicate the error. 
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NAME 


t_revuderr — receive a unit data error indication 


SYNOPSIS 


#include <tiuser.h> 


int t_revuderr(fd, uderr) 
int fd; 
struct t_uderr *uderr; 


DESCRIPTION 
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This function is used in connectionless mode to receive information concerning 
an error on a previously sent data unit, and should only be issued following a 
unit data error indication. It informs the transport user that a data unit with 
a specific destination address and protocol options produced an error. fd iden- 
tifies the local transport endpoint through which the error report will be 
received, and uderr points to a t_uderr structure containing the following 
members: 


struct netbuf addr; 
struct netbuf opt; 
long error; 


netbuf is described in intro(3). The maxlen [see netbuf in intro(3)] field of 
addr and opt must be set before issuing this function to indicate the maxi- 
mum size of the buffer for each. 


On return from this call, the addr structure specifies the destination protocol 
address of the erroneous data unit, the opt structure identifies protocol-spe- 
cific options that were associated with the data unit, and error specifies a pro- 
tocol-dependent error code. 


If the user does not care to identify the data unit that produced an error, 
uderr may be set to NULL and t_revuderr simply clears the error indication 
without reporting any information to the user. 


On failure, t_errno may be set to one of the following: 
[TBADF] The specified file descriptor does not refer to a transport 
endpoint. 


[TBUFOVFLW] The number of bytes allocated for the incoming protocol 
address or options is not sufficient to store the informa- 
tion. The unit data error information to be returned in 
uderr is discarded. 


[TNOUDERR] No unit data error indication currently exists on the speci- 
fied transport endpoint. 
([TNOTSUPPORT] This function is not supported by the underlying transport 
provider. 
(TSYSERR] A system error has occurred during execution of this func- 
tion. 
1 
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SEE ALSO 
intro(3), t_revudata(3N), t_sndudata(3N) 


DIAGNOSTICS 
t_revuderr returns 0 on successful completion and -1 on failure and t_errno 
is set to indicate the error. 


2 12/89 


DYNIX/ptx T_SND(3N) 


NAME 


t_snd — send data or expedited data over a connection 


SYNOPSIS 


#include <tiuser.h> 


int t_snd(fd, buf, nbytes, flags) 
int fd; 

char *buf 

unsigned nbytes; 

int *flags; 


DESCRIPTION 
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This function is used to send either normal or expedited data. fd identifies 
the local transport endpoint over which data should be sent, buf points to the 
user data, nbytes specifies the number of bytes of user data to be sent, and 
flags specifies any optional flags described below. 


By default, t_snd operates in synchronous mode and may wait if flow control 
restrictions prevent the data from being accepted by the local transport pro- 
vider at the time the call is made. However, if O_NDELAY is set (via t_open or 
fentl), t_snd executes in asynchronous mode, and fails immediately if there 
are flow control restrictions. 


Even when there are no flow control restrictions, t_snd waits if STREAMS 
internal resources are not available, regardless of the state of O.NDELAY. 


On successful completion, t_snd returns the number of bytes accepted by the 
transport provider. Normally this equals the number of bytes specified in 
nbytes. However, if O_NDELAY is set , it is possible that only part of the data 
will be accepted by the transport provider. In this case, t_snd sets T. MORE 
for the data that was sent (see below), and returns a value less than nbytes. 
If nbytes is zero, no data is passed to the provider and t_snd returns zero. 


If T_EXPEDITED is set in flags, the data is sent as expedited data, and is sub- 
ject to the interpretations of the transport provider. 


If T_MORE is set in flags, or is set as described above, an indication is sent to 
the transport provider that the transport service data unit (TSDU) or 
expedited transport service data unit (ETSDU) is being sent through multiple 
t_snd calls. Each t_snd with the T.MORE flag set indicates that another 
t_snd follows with more data for the current TSDU. The end of the TSDU (or 
ETSDU) is identified by a t_snd call with the T.MORE flag not set. Use of 
T_MORE enables a user to break up large logical data units without losing the 
boundaries of those units at the other end of the connection. The flag implies 
nothing about how the data is packaged for transfer below the transport inter- 
face. If the transport provider does not support the concept of a TSDU as indi- 
cated in the info argument on return from t_open or t_getinfo, the T MORE 
flag is not meaningful and should be ignored. 


The size of each TSDU or ETSDU must not exceed the limits of the transport 
provider as returned by t_open or t_getinfo. If the size is exceeded, a 
TSYSERR with system error EPROTO occurs. However, the t_snd may not fail 
because EPROTO errors may not be reported immediately. In this case, a sub- 
sequent call that accesses the transport endpoint fails with the associated 


TSYSERR. 
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If t_snd is issued from the T_IDLE state, the provider may silently discard the 
data. If t_snd is issued from any state other than T.DATAXFER, T_INREL, or 
T_IDLE, the provider generates a TSYSERR with system error EPROTO (which 
may be reported in the manner described above). 


On failure, t_errno may be set to one of the following: 


[TBADF] The specified file descriptor does not refer to a transport 
endpoint. 

[TFLOW] O_NDELAY was set, but the flow control mechanism pre- 
vented the transport provider from accepting data at 
this time. 

[TNOTSUPPORT] This function is not supported by the underlying trans- 
port provider. 

[TSYSERR] A system error [see intro(2)] has been detected during 
execution of this function. 

SEE ALSO 
t_open(3N), t_rcev(3N) 
DIAGNOSTICS 


On successful completion, t_snd returns the number of bytes accepted by the 
transport provider; on failure it returns —1 and t_errno is set to indicate the 
error. 
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NAME 


t_snddis — send user-initiated disconnect request 


SYNOPSIS 


#include <tiuser.h> 
int t_snddis(fd, call) 
int fd; 

struct t_call *call; 


DESCRIPTION 
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This function is used to initiate an abortive release on an already established 
connection or to reject a connect request. fd identifies the local transport end- 
point of the connection, and call specifies information associated with the 
abortive release. call points to a t_call structure which contains the follow- 
ing members: 


struct netbuf addr; 
struct netbuf opt; 
struct netbuf udata; 
int sequence; 


netbuf is described in intro(3). The values in call have different semantics, 
depending on the context of the call to t_snddis. When rejecting a connect 
request, call must be non-NULL and contain a valid value of sequence to 
uniquely identify the rejected connect indication to the transport provider. 
The addr and opt fields of call are ignored. In all other cases, call need only 
be used when data is being sent with the disconnect request. The addr, opt, 
and sequence fields of the t_call structure are ignored. If the user does not 
wish to send data to the remote user, the value of call may be NULL. 


udata specifies the user data to be sent to the remote user. The amount of 
user data must not exceed the limits supported by the transport provider as 
returned by t_open or t_getinfo. If the len field of udata is zero, no data is 
sent to the remote user. 


On failure, t_errno may be set to one of the following: 


[TBADF] The specified file descriptor does not refer to a transport 
endpoint. 
[TBADDATA] The amount of user data specified was not within the 


bounds allowed by the transport provider. The transport 
provider’s outgoing queue is flushed, so data may be lost. 


[TBADSEQ] An invalid sequence number was specified, or a NULL 
call structure was specified when rejecting a connect 
request. The transport provider’s outgoing queue is 
flushed, so data may be lost. 


[TLOOK] An asynchronous event has occurred on this transport 
endpoint and requires immediate attention. 


[TNOTSUPPORT] This function is not supported by the underlying trans- 
port provider. 


[TOUTSTATE] The function was issued in the wrong sequence. The 
transport provider’s outgoing queue may be flushed, so 
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data may be lost. & 
({TSYSERR] A system error has occurred during execution of this 
function. 
SEE ALSO 
intro(3), t_connect(3N), t_getinfo(3N), t_listen(3N), t_open(3N) 
DIAGNOSTICS 
t_snddis returns 0 on success and -1 on failure and t_errno is set to indicate 
the error. 
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NAME 
t_sndrel — initiate an orderly release 


SYNOPSIS 
finclude <tiuser.h> 


int t_sndrel(fd) 
int fd; 

DESCRIPTION 
This function is used to initiate an orderly release of a transport connection 
and indicates to the transport provider that the transport user has no more 
data to send. fd identifies the local transport endpoint where the connection 
exists. After issuing t_sndrel, the user may not send any more data over the 
connection. However, a user may continue to receive data if an orderly 
release indication has been received. 


This function is an optional service of the transport provider, and is only sup- 
ported if the transport provider returned service type T.COTS_ORD on t_open 


or t_getinfo. 

On failure, t_errno may be set to one of the following: 

[TBADF] The specified file descriptor does not refer to a transport 
endpoint. 

[TFLOW] O_NDELAY was set, but the flow control mechanism pre- 


vented the transport provider from accepting the func- 
tion at this time. 


[TNOTSUPPORT] This function is not supported by the underlying trans- 


port provider. 
[TSYSERR] A system error has occurred during execution of this 
function. 
SEE ALSO 
t_open(3N), t_revrel(3N) 
DIAGNOSTICS 
t_sndrel returns 0 on success and -1 on failure and t_errno is set to indicate 
the error. 
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NAME 
@ t_sndudata — send a data unit 


SYNOPSIS 
#include <tiuser.h> 


int t_sndudata(fd, unitdata) 
int fd; 
struct t_unitdata *unitdata; 

DESCRIPTION 
This function is used in connectionless mode to send a data unit to another 
transport user. fd identifies the local transport endpoint through which data 
will be sent, and unitdata points to a t_unitdata structure containing the 
following members: 


struct netbuf addr; 
struct netbuf opt; 
struct netbuf udata; 


netbuf is described in intro(3). In unitdata, addr specifies the protocol 

address of the destination user, opt identifies protocol-specific options that the 

user wants associated with this request, and udata specifies the user data to 

be sent. The user may choose not to specify what protocol options are associ- 

ated with the transfer by setting the len field of opt to zero. In this case, the 
) provider may use default options. 


If the len field of udata is zero, no data unit is passed to the transport pro- 
vider; t_sndudata will not send zero-length data units. 


By default, t_sndudata operates in synchronous mode and may wait if flow 
control restrictions prevent the data from being accepted by the local trans- 
port provider at the time the call is made. However, if O_NDELAY is set (via 
t_open or fentl), t_sndudata executes in asynchronous mode and fails under 
such conditions. 


If t_sndudata is issued from an invalid state, or if the amount of data speci- 
fied in udata exceeds the TSDU size as returned by t_open or t_getinfo, the 
provider generates an EPROTO protocol error. (See TSYSERR below.) 


On failure, t_errno may be set to one of the following: 


[TBADF] The specified file descriptor does not refer to a transport 
endpoint. 

[TFLOW] O_NDELAY was set, but the flow control mechanism pre- 
vented the transport provider from accepting data at this 
time. 

([TNOTSUPPORT] This function is not supported by the underlying transport 
provider. 

[TSYSERR] A system error has occurred during execution of this func- 


tion. 
© SEE ALSO 


intro(3), t_revudata(3N), t_revuderr(3N) 
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DIAGNOSTICS 
t_sndudata returns 0 on successful completion and -1 on failure t_errno is 
set to indicate the error. 
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NAME 


t_sync — synchronize transport library 


SYNOPSIS 


#include <tiuser.h> 


int t_sync(fd) 
int fd; 


DESCRIPTION 


For the transport endpoint specified by fd, t_sync synchronizes the data 
structures managed by the transport library with information from the under- 
lying transport provider. In doing so, it can convert a raw file descriptor : 
[obtained via open(2), dup(2), or as a result of a fork(2) and exec(2)] to an 
initialized transport endpoint, assuming that file descriptor referenced a 
transport provider. This function also allows two cooperating processes to 
synchronize their interaction with a transport provider. 


For example, if a process forks a new process and issues an exec, the new 
process must issue a t_sync to build the private library data structure associ- 
ated with a transport endpoint and to synchronize the data structure with the 
relevant provider information. 


It is important to remember that the transport provider treats all users of a 
transport endpoint as a single user. If multiple processes are using the same 
endpoint, they should coordinate their activities so as not to violate the state 
of the provider. t_sync returns the current state of the provider to the user, 
thereby enabling the user to verify the state before taking further action. 
This coordination is only valid among cooperating processes; it is possible that 
a process or an incoming event could change the provider's state after a 
t_sync is issued. 


If the provider is undergoing a state transition when t_sync is called, the 
function fails. 


On failure, t_errno may be set to one of the following: 


[TBADF] The specified file descriptor is a valid open file descriptor 
but does not refer to a transport endpoint. 


[TSTATECHNG] The transport provider is undergoing a state change. 


[TSYSERR] A system error has occurred during execution of this 
function. 


SEE ALSO 


dup(2), exec(2), fork(2), open(2) 


DIAGNOSTICS 
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t_sync returns the state of the transport provider on successful completion 
and -1 on failure and t_errno is set to indicate the error. The state returned 
may be one of the following: 


T_DATAXFER data transfer 
T_IDLE ide 
T_INCON incoming connection pending 
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T_LINREL 


T_OUTCON 
T_OUTREL 


T_UNBND 
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incoming orderly release (waiting for an orderly release 


request) 
outgoing connection pending 


outgoing orderly release (waiting for an orderly release 


indication) 
unbound 
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NAME 
© t_unbind — disable a transport endpoint 


SYNOPSIS 
#include <tiuser.h> 
int t_unbind(fd) 
int fd; 

DESCRIPTION 
The t_unbind function disables the transport endpoint specified by fd which 
was previously bound by t_bind (3N). On completion of this call, no further 
data or events destined for this transport endpoint will be accepted by the 
transport provider. 


On failure, t_errno may be set to one of the following: 


(TBADF] The specified file descriptor does not refer to a transport end- 
point. 

[TLOOK] An asynchronous event has occurred on this transport end- 
point. 


[TOUTSTATE] The function was issued in the wrong sequence. 
([TSYSERR] A system error has occurred during execution of this function. 


SEE ALSO 
t_bind(3N) 


DIAGNOSTICS 
t_unbind returns 0 on success and -1 on failure; t_errno is set to indicate the 
error. 
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DYNIX/ptx INTRO(3PPS) 


& NAME 


intro — introduction to Parallel Programming Library 


DESCRIPTION 


These routines constitute the Parallel Programming Library, which supports 
microtasking and multitasking in C, Pascal, and FORTRAN programs. (For 
information on microtasking and multitasking programming models, refer to 
the Guide to Parallel Programming.) 


The routines are contained in the file /usr/lib/libpps.a. These routines are 
linked into a program by including the -Ipps and —Iseq options in the ce or ld 
command line, or by including the -Ipps and -Iseq options, or the -mp option 
in the fortran command line. 


For an overview of how the Parallel Programming Library routines are used, 
and for sample programs and related information, refer to the Guide to Paral- 


lel Programming. 


LIST OF FUNCTIONS 


The following routines support microtasking: 


Name Appears on Page Description 
m_fork m_fork.3pps execute a subprogram in parallel 
m_get_myid m_get_myid.3pps return process identification 
m_get_numprocs m_get_numprocs.3pps _ get number of child processes 
m_kill_procs m_kill_procs.3pps kill child processes 

i) m_lock m_lock.3pps initialize and lock a lock 
m_multi m_single.3pps end single-process section 
m_next m_next.3pps increment global counter 
m_park_procs m_park_procs.3pps suspend child process execution 
m_rele_procs m_park_procs.3pps resume child process execution 
m_set_procs m_set_procs.3pps set number of child processes 
m_single m_single.3pps start single-process section 
m_sync m_sync.3pps check in at barrier 
m_unlock m_lock.3pps unlock a lock 


ALPHA 


The following routines support multitasking: 


Name Appears on Page Description 
cpus_online cpus_online.3pps return number of CPUs on-line 
s_clock s_lock.3pps lock a lock, return if 
unsuccessful 
S_CLOCK s_lock.3pps lock a lock, return if 
unsuccessful (C macro) 
s_init_barrier s_wait_barrier.3pps initialize a barrier 
S_INIT_BARRIER s_wait_barrier.3pps initialize a barrier (C macro) 
s_init_lock s_lock.3pps initialize a lock 
S_INIT_LOCK s_lock.3pps initialize a lock (C macro) 
s_lock s_lock.3pps lock a lock 
S_LOCK s_lock.3pps lock a lock (C macro) 
s_unlock s_lock.3pps unlock a lock 
S_UNLOCK s_lock.3pps unlock a lock (C macro) 
s_wait_barrier s_wait_barrier.3pps wait at a barrier 
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S_WAIT_BARRIER s_wait_barrier.3pps wait at a barrier (C macro) & 


The following routines support memory allocation for parallel programming. 
The brk and sbrk routines are available without loading the Parallel Pro- 
gramming library (see brk(2)), but the versions in the Parallel Programming 
library are necessary for compatibility with the rest of the library. 


Name Appears on Page Description 

brk brk.3pps change private data segment size 
sbrk brk.3pps change private data segment size 
shbrk shbrk.3pps change shared data segment size 
shfree shmalloc.3pps deallocate shared data memory 
shmalloc shmalloc.3pps allocate shared data memory 
shrealloc shmalloc.3pps reallocate shared data memory 
shsbrk shbrk.3pps change shared data segment size 
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NAME 

brk, sbrk — change private data segment size 
SYNOPSIS 

C syntax: 

#include <parallel/parallel.h> 

caddr_t brk(addr) 

caddr_t addr; 

caddr_t sbrk(incr) 

int incr; 

FORTRAN syntax 

none 


DESCRIPTION 
These routines are identical to the standard brk and sbrk (see brk(2)) rou- 
tines except that these routines verify that the private data segment does not 
overlap the shared data segment which follows it. If the brk or sbrk call will 
cause the segments to overlap, the routine issues an error. 

ERRORS 
If an error occurs, the return value is -1 and the variable errno contains the 
error code. brk and sbrk can return the following error codes: 


[ENOMEM] The requested private data segment will overlap the shared 
data segment. 


{ENOMEM] The routine cannot allocate file system space to expand the 
file which has been memory mapped to the shared data seg- 
ment (see mmap(2SEQ)). The routine tries to allocate file 
system space from directories in the following order: 


1. directory indicated by TMPPATH environment variable 
2. current directory 
3. user’s home directory 
4. directory /usr/tmp 
5. directory /tmp 
SEE ALSO 
execve(2), malloc(3), end(3), vm_ctl(2SEQ) 
NOTES 
The gap between the private data segment and the shared data segment can 
be adjusted by modifying the file /usr/sequent/gtpp.demo/ifile, and then 
including the ifile on the compiler command line as follows: 


cc -0 foo foo.c -Ipps —Iseq ifile 


Refer to the linker documentation in the Language Tools binder for more 
information about ifiles. 


When brk and sbrk increase a program’s address space, they also attempt to 
increase its allowable resident set size (see vm_ctl(2SEQ)). 


12/89 1 


DYNIX/ptx CPUS_ONLINE(3PPS) 


NAME 

cpus_online — returns the number of CPUs on-line 
SYNOPSIS 

C syntax 

int cpus_online (); 

FORTRAN syntax 

integer*4 function cpus_online 
DESCRIPTION 


The cpus_online routine returns the number of processors currently config- 
ured and on-line. 


SEE ALSO 
tmp_ctl(2seq) 
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DYNIX/ptx M_FORK(3PPS) 


m_fork — execute a subprogram in parallel 


SYNOPSIS 


C syntax: 

#include <parallel/microtask.h> 
m_fork(func[,arg,...]); 

void (*func)(); 

sometype args; 

FORTRAN syntax 

external func 

integer*4 m_fork 
i=m_fork(funcl,arg,...]) 
subroutine func(arg,...) 


DESCRIPTION 


The m_fork routine assigns a subprogram to child processes, which then coop- 
erate in executing the subprogram in parallel. The number of child processes 
used by the m_fork call can be set with a previous call to m_set_procs. If 
m_set_procs has not been called, the number of child processes defaults to 
(number of CPUs on-line) /2. If the program has no child processes from pre- 
vious m_fork calls, the call creates the child processes. If there are already 
child processes from a previous call, m_fork re-uses the existing processes. 


When an m_fork call creates child processes, each child process is given a pri- 
vate integer variable called m_myid, which identifies it within the set of child 
processes being created. The parent process’s identification number is always 
zero. The first child process’s identification is 1, the second’s is 2, and so on. 
You can call the routine m_getmyid to find out the identification number of a 
child process (see m_getmyid(3PPS)). 


For C programs, the header file / usr /include/parallel /microtask.h contains 
an external declaration of the variable m_myid and the variable m_numprocs, 
which indicates the total number of processes executing the subprogram 
(including all the child processes and the parent process). 


Once child processes are available, m_fork starts them executing the subpro- 
gram func with the given arguments. (For Pascal programs, func must be an 
inner scope procedure.) The child processes execute the subprogram until 
they all return from it. At this point, the program returns from the m_fork 
call and the child processes spin, waiting for more work. The program can 
either kill the child processes with a call to the routine m_kill, suspend them 
with a call to m_park_procs, or let the child processes spin until they are 
re-used by another m_fork call. If the child processes are to be re-used, the 
m_park_procs offers the most efficient use of the Sequent system, because it 
saves the CPU usage of having the processes spin and it saves the overhead of 
having to recreate processes on the next m_fork call. 


You must ensure that arguments passed to the subprogram func are either 
call-by-value arguments or addresses of data in shared memory. They must 
not be addresses in the parent’s private data segment. 


ERRORS 


The m_fork call fails and no child processes are created if any of the following 
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error conditions occurs: 

[EAGAIN] The m_fork call would exceed nproc, the system’s limit on 
the total number of executing processes. 

[EAGAIN] The m_fork call would exceed maxuprc, the system’s limit on 
executing processes for a single user. 

[EINVAL] This call to m_fork is nested within a previous call. 


NOTES 
Each call to m_fork resets the global counter (see m_next(3PPS)). 


SEE ALSO 
shmalloc(3PPS), brk(3PPS), m_set_procs(3PPS), m_kill_procs(3PPS), 
m_next(3PPS) 
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DYNIX/ptx M_GET_MYID(3PPS) 


NAME 


m_get_myid — return process identification 


SYNOPSIS 


C syntax: 

#include <parallel/microtask.h> 
int m_get_myid(); 

int i; 

i=m_get_myid(); 

FORTRAN syntax 

integer*4 function m_get_myid 


DESCRIPTION 


The m_get_myid routine returns the value of the variable m_myid, the pro- 
cess’s indentification number. For the parent process, this variable has the 
value zero. Child processes are assigned identification numbers in the order of 
their creation: the first child process has identification number 1, the second 
has 2, and so on. The C header file /usr /include/ parallel /microtask.h con- 
tains an external declaration of the variable. 


SEE ALSO 
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fortran(1), m_fork(3PPS) 


DYNIX/ptx M_GET_NUMPROCS(3PPS) 


NAME 
m_get_numprocs — return number of child processes 


SYNOPSIS 
C syntax: 
#include <parallel/microtask.h> 
int m_get_numprocs(); 
FORTRAN syntax 
integer*4 function m_get_numprocs 
DESCRIPTION 
The m_get_numprocs routine returns the value of the variable m_numprocs, 
the current number of processes in the program. This value reflects the num- 
ber of child processes plus one, the parent process. 


SEE ALSO 
fortran(1), m_set_procs(3PPS) 
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NAME 

m_kill_procs — kill child processes 
SYNOPSIS 

C syntax: 

#include <paralle)/microtask.h> 

m_kill_procs(); 

FORTRAN syntax 

subroutine m_kill_procs 


DESCRIPTION 
The m_kill_procs routine terminates the child processes created by a previ- 
ous call to m_fork. 


The m_kill_procs routine fails if it is called from a subprogram invoked by an 


m_fork call. 
ERRORS 
The m_kill_procs call fails if the following error condition occurs: 
[EINVAL] Some child processes are stil] executing within an m_fork 
call. 
SEE ALSO 


m_fork(3PPS) 
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NAME 
@ m_lock, m_unlock — lock, unlock locks 


SYNOPSIS 
C syntax: 
#include <parallel/microtask.h> 
m_lock (); 
m_unlock (); 
FORTRAN syntax 


subroutine m_lock() 
subroutine m_unlock() 

DESCRIPTION 
The m_lock and m_unlock routines are microtasking interfaces to a single 
slock_t-type lock. For a single lock, they are easier to use than the 
s_init_lock, s_lock, and s_unlock routines because they don’t require you to 
declare or initialize the lock before using it. They are also faster than the 
other routines because they do not pass the lock address as an argument. 


m_lock locks the lcck. m_lock is always successful; it spins as long as is nec- 
essary to acquire the lock. 


m_unlock unlocks the lock. 


SEE ALSO 
intro(3PPS), s_lock(3PPS), shmalloc(3PPS) 
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NAME 
m_next — increment global counter 


SYNOPSIS 
C syntax: 
#include <parallel/microtask.h> 
int m_next(); 
FORTRAN syntax 
integer*4 function m_next 
DESCRIPTION 
The m_next routine atomically increments a global counter. The program’s 


first call to m_next returns the value 1, the second returns 2, and soon. Calls 
to the m_fork, m_sync, or m_single routines reset the global counter to zero. 


SEE ALSO 
m_fork(3PPS), m_sync(3PPS), m_single(3PPS) 
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© NAME 


m_park_procs, m_rele_procs — suspend and resume child process execution 


SYNOPSIS 


C syntax: 


#include <parallel/microtask.h> 
m_park_procs(); 

(serial code) 

m_rele_procs(); 


FORTRAN syntax 


subroutine m_park_procs 
subroutine m_rele_procs 


DESCRIPTION 


The m_park_procs routine suspends execution of child processes created by 
an m_fork call. Typically, you would suspend child processes while the par- 
ent process is doing extensive I/O or setting up another phase of the program. 
The m_rele_procs routine resumes child process execution when the child 
processes are again required. 


Do not call m_park_procs when m_fork is executing. Likewise, do not call 
m_park_procs when the child processes are already suspended. To suspend 
child process execution within an m_fork call, use m_single and m_next. 


ERRORS 


These routines can return the following error: 


(EINVAL] The routine was called in an inappropriate context. For 
example, the routine was called from a subprogram executing 
in an m_fork call, or the processes were already suspended. 


SEE ALSO 
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NAME 
m_set_procs — set number of child processes 


SYNOPSIS 
C syntax: 


#include <parallel/microtask.h> 
int m_set_procs(nprocs); 
int nprocs; 


FORTRAN syntax 


integer*4 function m_set_procs(nprocs) 
integer*4 nprocs 

DESCRIPTION 
The m_set_procs routine declares the number of processes to execute subpro- 
grams in parallel on subsequent calls to m_fork. The argument nprocs 
declares the total number of processes that will run in parallel, including the 
parent process and the child processes. If nprocs is zero, the program creates 
no child processes, but all barriers and locks are initialized as if the program 
were going to create child processes. 


The m_set_procs routine initializes a shared variable called m_numprocs, 
which controls the number of processes created by subsequent calls to 
m_fork. The C header file /usr/include/parallel /microtask.h contains an 
external declaration of m_numprocs, as well as the constant MAXPROCS 
which determines the maximum number of processes that the system will 
@ allow the program to create. The other limiting factor is the number of CPUs 
on-line: m_nproes can be no more than the number of CPUs on-line minus 
one. 
The m_set_procs routine is optional: if the program does not call this routine 
before calling m_fork, the number of processes defaults to (number of CPUs 
on-line)/2. The program must not call m_set_procs while the child processes 
from an m_fork cal] are still alive (that is, before an m_kill_proes call to kill 
the child processes). 
ERRORS 
If an m_set_procs call is successful, the return value is zero. If the call fails, 
the return value is -1 and the variable errno holds the error code. 


The m_set_procs call fails if one of the following error conditions occurs: 


[EINVAL] The argument nprocs is greater than MAXPROCS or it is 
greater than or equal to the number of on-line CPUs. 
(EINVAL] Children from an m_fork call are already running. In this 


case, call m_kill_procs to kill the existing child processes 
before calling m_set_procs. 


SEE ALSO 
m_fork(3PPS), m_kill_procs(3PPS) 
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NAME 
m_single, m_multi — mark single-process code section 
SYNOPSIS 

C syntax: 

#include <parallel/microtask.h> 

m_single(); 

(CODE) 

m_multiQ; 

FORTRAN syntax 

subroutine m_single 

subroutine m_multi 

DESCRIPTION 

The m_single routine causes child processes to spin at a barrier until the par- 

ent process has executed the code following the m_single call and called the 

m_multi routine. The child processes then resume execution at the source 

line after the m_multi call. These routines are typically used to allow the 

parent process to perform I/O or other serial operations during an m_fork call. 
NOTES 

Calls to m_single are allowed only during m_fork calls. To suspend child 

processes after an m_fork call, use m_park_procs and m_rele_procs. 

Do not call m_multi without calling m_single first. 

Nested m_single calls are not allowed. Neither are m_single calls nested 

between calls to other lock routines, such as s_lock and s_unlock. 

ERRORS 

These routines can return the following error: 

[EINVAL] The routine was called in an inappropriate context. For 
example, m_fork had never been called, or the processes 
were already suspended with a call to m_park_procs. 

SEE ALSO 
m_park_procs(3PPS) 
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NAME 
m_sync — check in at barrier 
SYNOPSIS 
C syntax: 
#include <parallel/microtask.h> 
m_sync(); 
FORTRAN syntax 


subroutine m_sync 


DESCRIPTION 
The m_sync routine causes a process to spin until all cooperating processes 
have reached the same point and called m_syne. The program must not call 
the m_sync routine unless there are multiple processes executing; that is, 
unless the program is executing a subprogram during an m_fork call and is 
not between a pair of m_single/m_multi, m_lock/m_unlock, or 
s_lock/s_unlock calls. 

NOTES 
Calls to m_sync reset the global counter (see m_next(3PPS)). 


ERRORS 
This routine fails if the following occurs: 
[EINVAL] There are no child processes executing. 


SEE ALSO 
m_set_procs(3PPS), m_fork(3PPS), m_single(3PPS), m_park_procs(3PPS8), 
m_kill_procs(3PPS), m_next(3PPS) 
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NAME 


s_init_lock, s_lock, s_clock, s_unlock — initialize, lock, unlock locks 


SYNOPSIS 


C syntax: 


#include <parallel/parallel.h> 
slock_t *lp; 

s_init_lock (Ip); 
S_INIT_LOCK (Ip); 

s_lock (Ip); 

S_LOCK (Ip); 

s_clock (Ip); 

S_CLOCK (Ip); 

s_unlock (Ip); 

S_UNLOCK (Ip); 


FORTRAN syntax 


subroutine s_init_lock(p) 
subroutine s_lock(Ip) 
subroutine s_clock(Ip) 
subroutine s_unlock(Ip) 
integer*1 Ip 


DESCRIPTION 
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s_init_lock initializes a memory-based lock. After the lock is initialized, it 
can be locked with the s_lock or s_clock routine and unlocked with the 
s_unlock routine. There is no practical limit to the number of locks that can 
be used by a process. 


In the C language, a lock is a shared data structure of type slock_t, as shown 
in the following declaration statement: 


shared slock_t lock; 


In FORTRAN, a lock is an INTEGER*1 variable. A FORTRAN lock must be 
placed in shared memory by declaring it in a common block using the FOR- 
TRAN compiler -mp option, which places all variables into shared memory. 


s_lock and s_clock lock the lock whose address is lp. The lock must previ- 
ously have been initialized using s_init_lock. s_lock is always successful; it 
spins as long as is necessary to acquire the lock. s_clock is successful only if 
the lock is free; if the lock is held by another process, s_clock returns the 
value L_FAILED. s_clock can be used when a process does not need to 
acquire a particular lock (for instance, when another lock could be used 
instead). 

s_unlock unlocks the lock whose address is Ip. 

S_INIT_LOCK, S_LOCK, S_UNLOCK, and S_CLOCK are C-preprocessor 
macros. These macros are found in the header file /usr /include/parallel /par- 
allel.h. The macros are faster than the normal function calls, but they can 
add to the code size. See the source code in <parallel /parallel.h> for more 
information on the macros. 
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SEE ALSO 
intro(8PPS), shmalloc(3PPS), fortran(1), ld(1) @ 


NOTES 
The function names s_init_lock, s_lock, s_clock, and s_unlock are used in 
C, Pascal, and FORTRAN. In C, the Ip argument is passed as a pointer to the 
lock, while in FORTRAN, the argument is the address of the lock itself. 
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NAME 

s_init_barrier, s_wait_barrier — initialize barrier, wait at barrier 
SYNOPSIS 

C syntax: 

#include <parallel/parallel.h> 

s_init_barrier (bp, nprocs); 

sbarrier_t *bp; 

int nprocs; 

S_INIT_BARRIER (bp, nprocs); 


s_wait_barrier (bp); 
sbarrier_t *bp; 
S_WAIT_BARRIER (bp); 
FORTRAN syntax 
integer*4 barrier, nprocs 
subroutine s_init_barrier (barrier, nprocs) 
subroutine s_wait_barrier (barrier) 
DESCRIPTION 
S_init_barrier initializes a barrier as a rendezvous point for exactly nprocs 
processes. This barrier can be used subsequently with s_wait_barrier . 


In C, a barrier is a shared data structure of type sbarrier_t as shown in the 
@ following declaration statement: 


shared sbarrier_t barrier; 


In FORTRAN, a barrier is an INTEGER*4 variable. A FORTRAN barrier 
must be placed in shared memory either by declaring it in a common block and 
using the FORTRAN -mp option, which places all variables into shared mem- 
ory. 

s_wait_barrier delays the process in a busy wait until exactly nprocs 
processes have called s_wait_barrier. At that point, all processes exit the 
busy wait simultaneously. The barrier must have been previously initialized 
using s_init_barrier . 

Results are undefined if more than nprocs processes call s_wait_barrier. A 
barrier can be used any number of times without being re-initialized. A bar- 
rier should not be re-initialized while processes are waiting at the barrier. 


S_INIT_BARRIER and S_WAIT_BARRIER are C-preprocessor macros. These 
macros are found in the header file /usr/include/parallel /parallel.h. When 
compiled in line, the macros are faster than the normal function calls, but 
they can add to the code size. See the source code in <parallel/parallel.h> for 
more information on the macros. 


SEE ALSO 
intro(3PPS), shmalloc(3PPS) 
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NAME 
& shbrk, shsbrk — change shared data segment size 
SYNOPSIS 


C syntax: 


#include <parallel/parallel.h> 
caddr_t shbrk(addr) 
caddr_t addr; 


caddr_t shsbrk(incr) 
int incr; 
FORTRAN syntax 


none 


DESCRIPTION 


For a set of parallel processes executing a single application, shbrk sets the 
system’s idea of the lowest shared data segment location not used by the pro- 
gram (called the shared break) to addr (rounded up to the next multiple of the 
system’s page size). Locations greater than addr and below the stack pointer 
or another memory mapped region (see mmap(2SEQ)) are not in the address 
space and will thus cause a memory violation if accessed. 


In the alternate function, shsbrk, incr more bytes are added to the program’s 
shared data space and a pointer to the start of the new area is returned. 


When a program begins execution via execve, the shared break is set at the 
highest location defined by the program. Ordinarily, therefore, only programs 
with growing shared data areas need to use shsbrk. 


When shbrk and shsbrk increase a program’s address space, they also 
attempt to increase its allowable resident set size (see vm_ctl(2SEQ)). 


RETURN VALUE 


Zero is returned if the shared break could be set; —1 if the program requests 
more memory than the system limit. shsbrk returns —1 if the break could not 
be set. 


ERRORS 
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shbrk and shsbrk fails and no additional memory is allocated if any of the 
following error conditions occur: 


{EINVAL] The shared break address would be lowered. 


(ENOMEM] The routine cannot allocate file system space to expand the 
file which has been memory mapped to the shared data seg- 
ment (see mmap(2SEQ)). The routine tries to allocate file 
system space from directories in the following order: 


1. the directory indicated by the $TMPPATH environment 
variable 

2. the current directory 

3. the user’s home directory 

4. the directory /usr/tmp 

5. the directory /tmp 
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[ENOMEM] The new shared data segment would overlap the stack seg- 
ment. 


SEE ALSO 
execve(2), shmalloc(3PPS), end(3), vm_ctl(2SEQ), mmap(2SEQ) 


BUGS 
At this time, the size of the shared data segment can only be increased. 


The shared break cannot be set above the stack segment limit for any of the 
processes in the program. (Remember that each process can have a different 
stack size.) Ifa process sets the shared break above the bottom of any pro- 
cess’s stack, any reference to the overlapping area of that stack causes a core 
dump and aborts the program with a status of SIGSEGV. 


shbrk and shsbrk use the SIGSEGV signal and signal handler for internal 
purposes. Users who declare their own SIGSEGV handler cannot expect reli- 
able results from these routines. 


Ifa shbrk or shsbrk call causes the shared data segment to overlap a mem- 
ory mapped region, the shared data segment replaces the mapped region. 
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NAME 
shmalloc, shrealloc, shfree — shared memory allocator 


SYNOPSIS 
C syntax: 


char *shmalloc(size) 
unsigned size; 
shfree(ptr) 

char *ptr; 

char *shrealloc(prt,size) 
char *ptr; 

unsigned size; 
FORTRAN syntax 


none 


DESCRIPTION 
shmalloc, shrealloc, and shfree provide a simple general-purpose shared 
memory allocation package for a set of processes executing a single applica- 
tion. To use these routines, the program must have been linked with the Par- 
allel Programming Library and libseg.c. shmalloc returns a pointer toa 
block of at least size bytes beginning on a 4-byte word boundary. 


The argument to shfree is a pointer to a block previously allocated by shmal- 
loc; this space is made available for further allocation, but its contents are left 


& undisturbed. 
Grave disorder results if the space assigned by shmalloc is overrun or if some 
random number is handed to shfree. 


shmalloc maintains multiple lists of free blocks according to size, allocating 
space from the appropriate list. It calls shsbrk (see shbrk(3PPS)) to get more 
memory from the system when there is no suitable space already free. shmal- 
loc and shfree coordinate the allocation of shared memory among the 
processes in the task. They maintain a consistent list of free blocks even when 
several processes are allocating shared memory concurrently. Concurrent 
requests for shared memory blocks always return unique blocks from the pro- 
gram’s shared data segment. 


shrealloc changes the size of the block pointed to by ptr to size bytes and 
returns a pointer to the (possibly moved) block. The contents will be 
unchanged up to the lesser of the new and old sizes. If ptr points to a freed 
block, shrealloc returns NULL. 


When any of these allocation routines increases a program’s address space, it 
also attempts to increase its allowable resident set size (see vm_ctl(2SEQ)). 


DIAGNOSTICS 
shmalloc returns a NULL pointer (0) if there is no available shared memory 
or if the region has been detectably corrupted by storing data outside the 
bounds of a block. shmalloc may be recompiled to check the arena very strin- 
gently on every transaction; those sites with a source code license may check 
the source code to see how this can be done. 


SEE ALSO 
shbrk(3PPS), vm_ctl(2SEQ) 
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NAME 


ctermid — generate filename for terminal 


SYNOPSIS 


include <stdio.h> 
char *ctermid (s) 
char *g; 


DESCRIPTION 


NOTES 


ctermid generates the pathname of the controlling terminal for the current 
process, and stores it in a string. 


If s is a NULL pointer, the string is stored in an internal static area, the con- 
tents of which are overwritten at the next call to ctermid, and the address of 
which is returned. Otherwise, s is assumed to point to a character array of at 
least L_ctermid elements; the pathname is placed in this array and the value 
of s is returned. The constant L_ctermid is defined in the <stdio.h> header 
file. 


The difference between ctermid and ttyname(3C) is that ttyname must be 
handed a file descriptor and returns the actual name of the terminal associ- 
ated with that file descriptor, while ctermid returns a string (/dev/tty) that 
will refer to the terminal if used as a filename. Thus ttyname is useful only if 
the process already has at least one file open to a terminal. 


SEE ALSO 
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NAME 
cuserid — get character login name of the user 


SYNOPSIS 
#include <stdio.h> 


char *cuserid (s) 
char *8; 

DESCRIPTION 
cuserid generates a character-string representation of the login name that 
the owner of the current process is logged in under. If s is a NULL pointer, 
this representation is generated in an internal static area, the address of 
‘which is returned. Otherwise, s is assumed to point to an array of at least 
L_cuserid characters; the representation is left in this array. The constant 
L_cuserid is defined in the <stdio.h> header file. 


DIAGNOSTICS 
If the login name cannot be found, cuserid returns a NULL pointer; ifs is not 


a NULL pointer, a null character (\0) will be placed at s[0]. 


SEE ALSO 
getlogin(3C), getpwent(3C). 
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NAME 
felose, flush — close or flush a stream 


SYNOPSIS 
#include <stdio.h> 
int fclose (stream) 
FILE *stream; 
int fflush (stream) 
FILE *stream; 
DESCRIPTION 
fclose causes any buffered data for the named stream to be written out, and 
the stream to be closed. 
fclose is performed automatically for all open files upon calling exit(2). 
fflush causes any buffered data for the named stream to be written to that 
file. The stream remains open. 


SEE ALSO 
close(2), exit(2), fopen(3S), setbuf(3S), stdio(3S) 


DIAGNOSTICS 
These functions return 0 for success, and EOF if any error (such as trying to 


write to a file that has not been opened for writing) was detected. 


12/89 


DYNIX/ptx FERROR(38) 


NAME 
ferror, feof, clearerr, fileno — stream status inquiries 


SYNOPSIS 
#include <stdio.h> 


int ferror (stream) 
FILE *stream; 
int feof (stream) 
FILE *stream; 
void clearerr (stream) 
FILE *stream; 
int fileno (stream) 
FILE *stream; 
DESCRIPTION 
ferror returns non-zero when an I/O error has previously occurred reading 
from or writing to the named stream, otherwise zero. 
feof returns non-zero when EOF has previously been detected reading the 
named input stream, otherwise zero. 
clearerr resets the error indicator and EOF indicator to zero on the named 
stream. 
fileno returns the integer file descriptor associated with the named stream; 


© see open(2). 
NOTES 


All these functions are implemented as macros; they cannot be declared or 
redeclared. 


SEE ALSO 
open(2), fopen(3S), stdio(3S) 
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NAME 
fopen, freopen, fdopen — open a stream 
SYNOPSIS 


#include <stdio.h> 

FILE *fopen (filename, type) 

char *filename, *type; 

FILE *freopen (filename, type, stream) 
char *filename, *type; 

FILE *stream; 

FILE *fdopen (fildes, type) 

int fildes; 

char *type; 


DESCRIPTION 
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fopen opens the file named by filename and associates a stream with it. 
fopen returns a pointer to the FILE structure associated with the stream. 


filename points to a character string that contains the name of the file to be 
opened. 


Type is a character string having one of the following values: 


r open for reading 

w truncate or create for writing 

a append; open for writing at end of file, or create for writing 
m open for update (reading and writing) 

wt truncate or create for update 

at append; open or create for update at end-of-file 


freopen substitutes the named file in place of the open stream. The original 
stream is closed, regardless of whether the open ultimately succeeds. freo- 
pen returns a pointer to the FILE structure associated with stream. 


freopen is typically used to attach the preopened streams associated with 
stdin, stdout and stderr to other files. 


fdopen associates a stream with a file descriptor. File descriptors are 
obtained from open, dup, creat, or pipe(2), which open files but do not 
return pointers to a FILE structure stream. Streams are necessary input for 
many of the Section 3S library routines. The type of stream must agree with 
the mode of the open file. 


When a file is opened for update, both input and output may be done on the 
resulting stream. However, output may not be directly followed by input 
without an intervening fseek or rewind, and input may not be directly fol- 
lowed by output without an intervening fseek, rewind, or an input operation 
which encounters end-of-file. 


When a file is opened for append (i.e., when type is a or a+), it is impossible to 
overwrite information already in the file. feeek may be used to reposition the 
file pointer to any position in the file, but when output is written to the file, 
the current file pointer is disregarded. All output is written at the end of the 
file and causes the file pointer to be repositioned at the end of the output. If 
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two separate processes open the same file for append, each process may write 
freely to the file without fear of destroying output being written by the other. 
The output from the two processes will be intermixed in the file in the order in 
which it is written. 

SEE ALSO 
creat(2), dup(2), open(2), pipe(2), felose(3S), fseek(3S), stdio(3S), getdta- 
blesize(2seq), setdtablesize(2seq), getdtablemax(2seq) 


DIAGNOSTICS 
fopen, fdopen, and freopen return a NULL pointer on failure. 
ERRORS 
[ENOMEM] There is not enough available memory to allocate additional 
FILE structures. 
[EMFILE] Too many files are open. 
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NAME 

fread, fwrite — binary input/output 
SYNOPSIS 

#include <stdio.h> 

#include <sys/types.h> 


int fread (ptr, size, nitems, stream) 

char *ptr; 

int nitems; 

size_t size; 

FILE *stream; 

int fwrite (ptr, size, nitems, stream) 

char *ptr; 

int nitems; 

size_t size; 

FILE *stream; 

DESCRIPTION 

fread copies, into an array pointed to by ptr, nitems items of data from the 

named input stream, where an item of data is a sequence of bytes (not neces- 

sarily terminated by a null byte) of length size. fread stops appending bytes 

if an end-of-file or error condition is encountered while reading stream, or if 

nitems items have been read. fread leaves the file pointer in stream, if 

defined, pointing to the byte following the last byte read if there is one. fread 
@ does not change the contents of stream. 


fwrite appends at most nitems items of data from the array pointed to by 
ptr to the named output stream. fwrite stops appending when it has 
appended nitemes items of data or if an error condition is encountered on 
stream. fwrite does not change the contents of the array pointed to by ptr. 


The argument size is typically sizeof(*ptr) where the pseudofunction sizeof 
specifies the length of an item pointed to by ptr. If ptr points toa data type 
other than char it should be cast into a pointer to char. 

SEE ALSO 
read(2), write(2), fopen(3S), gete(3S), gets(3S), printf(3S), putc(3S), puts(38), 
scanf(3S), stdio(3S) 

DIAGNOSTICS 
fread and fwrite return the number of items read or written. If nitems is 
non-positive, no characters are read or written and 0 is returned by both 
fread and fwrite. 
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NAME 
fseek, rewind, ftell — reposition a file pointer in a stream 


SYNOPSIS 
#tinclude <stdio.h> 


int feeek (stream, offset, ptrname) 
FILE *stream; 
long offset; 
int ptrname; 
void rewind (stream) 
FILE *stream; 
long ftell (stream) 
FILE *stream; 
DESCRIPTION 
fseek sets the position of the next input or output operation on the stream. 
The new position is at the signed distance offset bytes from the beginning, 
from the current position, or from the end of the file, according as ptrname 
has the value 0, 1, or 2. 


rewind (stream) is equivalent to fseek(stream,0,0), except that no value is 
returned. 


fseek and rewind undo any effects of ungete(3S). 


After fseek or rewind, the next operation on a file opened for update may be 
either input or output. 


ftell returns the offset of the current byte relative to the beginning of the file 
associated with the named stream. 


SEE ALSO 
lseek(2), fopen(3S), popen(3S), stdio(3S), ungetc(3S) 


DIAGNOSTICS 
fseek returns non-zero for improper seeks, otherwise zero. An improper seek 
can be, for example, an fseek done on a file that has not been opened via 
fopen; in particular, feeek may not be used on a terminal, or on a file opened 
via popen(3S). 

WARNINGS 
Although on the DYNIX/ptx system an offset returned by ftell is measured in 
bytes, and it is permissible to seek to positions relative to that offset, portabil- 
ity to non-UNIX systems requires that an offset be used by feeek directly. 
Arithmetic may not meaningfully be performed on such an offset, which is not 
necessarily measured in bytes. 
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NAME 


getc, getchar, fgetc, getw — get character or word from a stream 


SYNOPSIS 


#include <stdio.h> 


int getc (stream) 
FILE *stream; 


int getchar () 
int fgetc (stream) 
FILE *stream; 
int getw (stream) 
FILE *stream; 


DESCRIPTION 


getc returns the next character (i.e., byte) from the named input stream, as 
an integer. It also moves the file pointer, if defined, ahead one character in 
stream. getchar is defined as getc(stdin). gete and getchar are macros. 


fgetc behaves like getc, but is a function rather than a macro. fgete runs 
more slowly than gete, but it takes less space per invocation and its name can 
be passed as an argument to a function. 


getw returns the next word (i.e., integer) from the named input stream. 
getw increments the associated file pointer, if defined, to point to the next 
word. The size of a word is the size of an integer and varies from machine to 
machine. getw assumes no special alignment in the file. 


SEE ALSO 


felose(3S), ferror(3S), fopen(3S), fread(3S), gets(3S), pute(3S), scanf(3S), 
stdio(3S) 


DIAGNOSTICS 


These functions return the constant EOF at end-of-file or upon an error. 
Because EOF is a valid integer, ferror(3S) should be used to detect getw 
errors. 


WARNINGS 
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If the integer value returned by getc, getchar, or fgetc is stored into a char- 
acter variable and then compared against the integer constant EOF, the com- 
parison may never succeed, because sign-extension of a character on widening 
to integer is machine-dependent. 


Because it is implemented as a macro, gete evaluates a stream argument 
more than once. In particular, getc(*f++) does not work sensibly. fgete 
should be used instead. 


Because of possible differences in word length and byte ordering, files written 
using putw are machine-dependent, and may not be read using getw on a dif- 
ferent processor. 
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NAME 
gets, fgets — get a string from a stream 


SYNOPSIS 
#include <stdio.h> 


char *gets (s) 
char *s; 


char *fgets (s, n, stream) 
char *s; 
int n; 
FILE *stream; 

DESCRIPTION 
gets reads characters from the standard input stream, stdin, into the array 
pointed to by s, until a new-line character is read or an end-of-file condition is 
encountered. The new-line character is discarded and the string is terminated 
with a null character. 


fgets reads characters from the stream into the array pointed to by s, until 
n-1 characters are read, or a new-line character is read and transferred to s, 
or an end-of-file condition is encountered. The string is then terminated with 
a null character. 


SEE ALSO 
ferror(3S), fopen(3S), fread(3S), getc(3S), scanf(3S), stdio(3S) 


DIAGNOSTICS 
If end-of-file is encountered and no characters have been read, no characters 
are transferred to s and a NULL pointer is returned. Ifa read error occurs, 
such as trying to use these functions on a file that has not been opened for 
reading, a NULL pointer is returned. Otherwise s is returned. 
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NAME 
popen, pclose — initiate pipe to/from a process 


SYNOPSIS 
#include <stdio.h> 


FILE *popen (command, type) 
char *command, *type; 


int pclose (stream) 
FILE *stream; 


DESCRIPTION 
popen creates a pipe between the calling program and the command to be 
executed. The arguments to popen are pointers to null-terminated strings. 
command consists of a shell command line. type is an I/O mode, either r for 
reading or w for writing. The value returned is a stream pointer such that 
one can write to the standard input of the command, if the I/O mode is w, by 
writing to the file stream; and one can read from the standard output of the 
command, if the I/O mode is r, by reading from the file stream. 


A stream opened by popen should be closed by pclose, which waits for the 
associated process to terminate and returns the exit status of the command. 


Because open files are shared, a type r command may be used as an input fil- 
ter and a type w as an output filter. 


EXAMPLE 
& A typical call may be: 
char *cmd = "ls *.c'™; 
FILE *ptr; 
if ((ptr = popen(cmd, "r")) != NULL) 
while (fgets(buf, n, ptr) != NULL) 


(void) printf ("%s ",buf); 
This will print in stdout [see stdio (3S)] all the file names in the current 
directory that have a.c suffix. 
SEE ALSO 
pipe(2), wait(2), fclose(3S), fopen(3S), stdio(3S), system(3S). 
DIAGNOSTICS 
popen returns a NULL pointer if files or processes cannot be created. 
pelose returns —1 if stream is not associated with a popened command. 
WARNINGS 
If the original and popened processes concurrently read or write a common 
file, neither should use buffered I/O, because the buffering gets all mixed up. 
Problems with an output filter may be forestalled by careful buffer flushing, 
e.g. with fflush (see felose(3S)). 
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@ NAME 


printf, fprintf, sprintf — print formatted output 


SYNOPSIS 


#include <stdio.h> 

int printf (format , arg... ) 

char *format; 

int fprintf (stream, format , arg ... ) 
FILE *stream; 

char *format; 


int sprintf (s, format [, arg ] ...) 
char *s, *format; 


DESCRIPTION 
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printf places output on the standard output stream stdout. fprintf places 
output on the named output stream. sprintf places “output,” followed by the 
null character (\0), in consecutive bytes starting at *s; it is the user’s respon- 
sibility to ensure that enough storage is available. Each function returns the 
number of characters transmitted (not including the \0 in the case of 
sprintf), or a negative value if an output error was encountered. 


Each of these functions converts, formats, and prints its args under control of 
the format. The format is a character string that contains two types of 
objects: plain characters, which are simply copied to the output stream, and 
conversion specifications, each of which results in fetching of zero or more 
args. The results are undefined if there are insufficient args for the format. 
If the format is exhausted while args remain, the excess args are simply 
ignored. 


Each conversion specification is introduced by the character %. After the %, 
the following appear in sequence: 


Zero or more flags, which modify the meaning of the conversion speci- 
fication. 


An optional decimal digit string specifying a minimum field width. If 
the converted value has fewer characters than the field width, it will 
be padded on the left (or right, if the left-adjustment flag ~’, described 
below, has been given) to the field width. The padding is with blanks 
unless the field width digit string starts with a zero, in which case the 
padding is with zeros. 


A precision that gives the minimum number of digits to appear for 
the d, i, o, u, x, or X conversions, the number of digits to appear after 
the decimal point for the e, E, and f conversions, the maximum num- 
ber of significant digits for the g and G conversion, or the maximum 
number of characters to be printed from a string in s conversion. The 
precision takes the form of a period (.) followed by a decimal digit 
string; a null digit string is treated as zero. Padding specified by the 
precision overrides the padding specified by the field width. 


An optional 1 (ell) specifying that a following d, i, 0, u, x, or X conver- 
sion character applies to a long integer arg. An 1 before any other 
conversion character is ignored. 


PRINTF(38) DYNIX/ptx 


Acharacter that indicates the type of conversion to be applied. 


A field width or precision or both may be indicated by an asterisk (*) instead of 
a digit string. In this case, an integer arg supplies the field width or preci- 
sion. The arg that is actually converted is not fetched until the conversion 
letter is seen, so the args specifying field width or precision must appear 
before the arg (if any) to be converted. A negative field width argument is 
taken as a ~’ flag followed by a positive field width. If the precision argument 
is negative, it will be changed to zero. 


The flag characters and their meanings are: 
- The result of the conversion will be left-justified within the field. 


+ The result of a signed conversion will always begin with a sign (+ or 


-). 


blank If the first character of a signed conversion is not a sign, a blank 
will be prefixed to the result. This implies that if the blank and + 
flags both appear, the blank flag will be ignored. 


# This flag specifies that the value is to be converted to an alternate 
form. For e, d, i, s, and u conversions, the flag has no effect. For o 
conversion, it increases the precision to force the first digit of the 
result to be a zero. For x or X conversion, a non-zero result will 
have Ox or OX prefixed to it. For e, E, f, g, and G conversions, the 
result will always contain a decimal point, even if no digits follow 
the point (normally, a decimal point appears in the result of these 
conversions only if a digit follows it). For g and G conversions, 
trailing zeros will not be removed from the result (which they nor- 
mally are). 

The conversion characters and their meanings are: 

d,i,o,u,x,X 
The integer arg is converted to signed decimal (d or i), unsigned 
octal, (0), decimal (u), or hexadecimal notation (x or X), respec- 
tively; the letters abcdef are used for x conversion and the letters 
ABCDEF for X conversion. The precision specifies the minimum 
number of digits to appear; if the value being converted can be rep- 
resented in fewer digits, it will be expanded with leading zeros. 
The default precision is 1. The result of converting a zero value 
with a precision of zero is a null string. 


f The float or double arg is converted to decimal notation in the 
style ‘[-]ddd.ddd,” where the number of digits after the decimal 
point is equal to the precision specification. If the precision is miss- 
ing, six digits are output; if the precision is explicitly 0, no decimal 
point appears. 


eE The float or double arg is converted in the style “[-]d.dddetdd,” 


where there is one digit before the decimal point and the number of 
digits after it is equal to the precision; when the precision is 
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missing, six digits are produced; if the precision is zero, no decimal 

@ point appears. The E format code will produce a number with E 
instead of e introducing the exponent. The exponent always con- 
tains at least two digits. 


£,G The float or double arg is printed in style f or e (or in style Ein the 
case of a G format code), with the precision specifying the number 
of significant digits. The style used depends on the value con- 
verted: style e will be used only if the exponent resulting from the 
conversion is less than —4 or greater than the precision. Trailing 
zeros are removed from the result; a decimal point appears only if it 


is followed by a digit. 
c The character arg is printed. 
8 The arg is taken to be a string (character pointer) and characters 


from the string are printed until a null character (\O) is encoun- 
tered or the number of characters indicated by the precision specifi- 
cation is reached. If the precision is missing, it is taken to be infi- 
nite, so all characters up to the first null character are printed. A 
NULL value for arg will yield undefined results. 


% Print a %; no argument is converted. 


and the mantissa is not equal to zero, then the output is 
[-INaNOxdddddddd 


where Oxddddddddis the hexadecimal representation of the leftmost 32 bits of 
the mantissa. If the mantissa is zero, the output is 


[tlinf. 


In no case does a non-existent or small field width cause truncation of a field; 
if the result of a conversion is wider than the field width, the field is simply 
expanded to contain the conversion result. Characters generated by printf 
and fprintf are printed as if pute(3S) had been called. 


EXAMPLES 
To print a date and time in the form “Sunday, July 3, 10:02,” where weekday 
and month are pointers to null-terminated strings: 


. In printing floating-point types (float and double), if the exponent is Ox7FF 


printf("%s, %s %i, %d:%.2d", weekday, month, day, hour, min); 
To print 1 to 5 decimal places: 
printf("pi = %.5f", 4 * atan(1.0)); 


SEE ALSO 
ecvt(3C), pute(3S), scanf(3S), stdio(3S) 
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NAME 
pute, putchar, fputc, putw — put character or word on a stream 
SYNOPSIS 


#include <stdio.h> 
int pute (c, stream) 
int c; 

FILE *stream; 

int putchar (c) 

int c; 

int fpute (c, stream) 
int c; 

FILE *stream; 

int putw (w, stream) 
int w; 

FILE *stream; 


DESCRIPTION 


pute writes the character ¢ onto the output stream (at the position where 
the file pointer, if defined, is pointing). putchar(c) is defined as 
pute(c,stdout). pute and putchar are macros. 


fputc behaves like pute, but is a function rather than a macro. fpute runs 
more slowly than pute, but it takes less space per invocation and its name can 
be passed as an argument to a function. 


putw writes the word (i.e. integer) w to the output stream (at the position at 
which the file pointer, if defined, is pointing). The size of a word is the size of 
an integer and varies from machine to machine. putw neither assumes nor 
causes special alignment in the file. 


SEE ALSO 


felose(3S), ferror(3S), fopen(3S), fread(3S), printf(3S), puts(3S), setbuf(3S), 
stdio(3S) 


DIAGNOSTICS 


On success, these functions (with the exception of putw) each return the 
value they have written. [Putw returns ferror (stream)]. On failure, they 
return the constant EOF. This occurs if the file stream is not open for writing 
or if the output file cannot grow. Because EOF is a valid integer, ferror(3S) 
should be used to detect putw errors. 


WARNINGS 
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Because it is implemented as a macro, pute evaluates a stream argument 
more than once. In particular, putc(c, *f£++) ; doesn’t work sensibly. 
fputc should be used instead. 


Because of possible differences in word length and byte ordering, files written 
using putw are machine-dependent, and may not be read using getw on a dif- 


ferent processor. 
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NAME 
puts, fputs — put a string on a stream 


SYNOPSIS 
#include <stdio.h> 
int puts (s) 
char *s; 
int fputs (s, stream) 
char *8; 
FILE *stream; 
DESCRIPTION 
puts writes the null-terminated string pointed to by s, followed by a new-line 
character, to the standard output stream stdout. 
fputs writes the null-terminated string pointed to by s to the named output 
stream. 


Neither function writes the terminating null character. 


SEE ALSO 
ferror(3S), fopen(3S), fread(3S), print{(3S), pute(3S), stdio(3S) 


DIAGNOSTICS 
Both routines return EOF on error. This will happen if the routines try to 
write on a file that has not been opened for writing. 


NOTES 
puts appends a new-line character while fputs does not. 
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© NAME 


scanf, fscanf, sscanf— convert formatted input 


SYNOPSIS 


#include <stdio.h> 

int scanf (format [, pointer]... ) 

char *format; 

int fscanf (stream, format [, pointer]... ) 
FILE *stream; 

char *format; 

int sscanf (s, format [, pointer]... ) 

char *s, *format; 


DESCRIPTION 
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scanf reads from the standard input stream stdin. fecanf reads from the 
named input stream. Sscanf reads from the character string s. Each func- 
tion reads characters, interprets them according to a format, and stores the 
results in its arguments. Each expects, as arguments, a control string format 
described below, and a set of pointer arguments indicating where the con- 
verted input should be stored. The results are undefined in there are insuffi- 
cient args for the format. If the format is exhausted while args remain, the 
excess args are simply ignored. 


The control string usually contains conversion specifications, which are used 
to direct interpretation of input sequences. The control string may contain: 


1. White-space characters (blanks, tabs, new-lines, or form-feeds) which, 
except in two cases described below, cause input to be read up to the next 
non-white-space character. 


2. An ordinary character (not %), which must match the next character of the 
input stream. 


3. Conversion specifications, consisting of the character %, an optional 
assignment suppressing character *, an optional numerical maximum field 
width, an optional 1 (ell) or h indicating the size of the receiving variable, 
and a conversion code. 


Aconversion specification directs the conversion of the next input field; the 
result is placed in the variable pointed to by the corresponding argument, 
unless assignment suppression was indicated by *. The suppression of assign- 
ment provides a way of describing an input field which is to be skipped. An 
input field is defined as a string of non-space characters; it extends to the next 
inappropriate character or until the field width, if specified, is exhausted. For 
all descriptors except ‘{” and “c”, white space leading an input field is ignored. 


The conversion code indicates the interpretation of the input field; the corre- 
sponding pointer argument must usually be of a restricted type. For a 
suppressed field, no pointer argument is given. The following conversion codes 
are legal: 

% a single % is expected in the input at this point; no assignment is done. 
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a decimal integer is expected; the corresponding argument should be 
an integer pointer. 


an unsigned decimal integer is expected; the corresponding argument 
should be an unsigned integer pointer. 


an octal integer is expected; the corresponding argument should be an 
integer pointer. 


a hexadecimal integer is expected; the corresponding argument should 
be an integer pointer. 


an integer is expected; the corresponding argument should be an inte- 
ger pointer. It will store the value of the next input item interpreted 
according to C conventions: a leading “0” implies octal; a leading “Ox” 
implies hexadecimal; otherwise, decimal. 


stores in an integer argument the total number of characters (includ- 
ing white space) that have been scanned so far since the function call. 
No input is consumed. 


a floating-point number is expected; the next field is converted accord- 
ingly and stored through the corresponding argument, which should 
be a pointer to a float. The input format for floating-point numbers is 
an optionally signed string of digits, possibly containing a decimal 
point, followed by an optional exponent field consisting of an E or an e, 
followed by an optional +, —, or space, followed by an integer. 


a character string is expected; the corresponding argument should be 

a character pointer pointing to an array of characters large enough to 
accept the string and a terminating \0, which will be added automati- 
cally. The input field is terminated by a white-space character. 


a character is expected; the corresponding argument should be a char- 
acter pointer. The normal skip over white space is suppressed in this 
case; to read the next non-space character, use %l1s. Ifa field width is 
given, the corresponding argument should refer to a character array; 
the indicated number of characters is read. 


indicates string data and the normal skip over leading white space is 
suppressed. The left bracket is followed by a set of characters, which 
we will call the scanset, and a right bracket; the input field is the max- 
imal sequence of input characters consisting entirely of characters in 
the scanset. The circumflex (*), when it appears as the first character 
in the scanset, serves as a complement operator and redefines the 
scanset as the set of all characters not contained in the remainder of 
the scanset string. There are some conventions used in the construc- 
tion of the scanset. A range of characters may be represented by the 
construct first—last, thus [0123456789] may be expressed [0-9]. Using 
this convention, first must be lexically less than or equal to /ast, or 
else the dash will stand for itself. The dash will also stand for itself 


12/89 


DYNIX/ptx SCANF(3S) 


whenever it is the first or the last character in the scanset. To include 
the right square bracket as an element of the scanset, it must appear 
as the first character (possibly preceded by a circumflex) of the scan- 
set, and in this case it will not be syntactically interpreted as the clos- 
ing bracket. The corresponding argument must point to a character 
array large enough to hold the data field and the terminating \0, 
which will be added automatically. At least one character must match 
for this conversion to be considered successful. 


The conversion characters d, u, 0, x and i may be preceded by I or h to indi- 
cate that a pointer to long or to short rather than to int is in the argument 
list. Similarly, the conversion characters e, f, and g may be preceded by 1 to 
indicate that a pointer to double rather than to float is in the argument list. 
The 1 or h modifier is ignored for other conversion characters. 


scanf conversion terminates at EOF, at the end of the control string, or when 
an input character conflicts with the control string. In the latter case, the 
offending character is left unread in the input stream. 


scanf returns the number of successfully matched and assigned input items; 
this number can be zero in the event of an early conflict between an input 
character and the control string. If the input ends before the first conflict or 
conversion, EOF is returned. 


EXAMPLES 


The call: 


int n; float x; char name[50]; 
n = scanf ("%d%f%s", &i, &x, name); 


with the input line: 
25 54.32E-1 thompson 


will assign to n the value 8, to i the value 25, to x the value 5.432, and name 
will contain thompson\0 . Or: 


int 41, j; float x; char name[50]; 
(void) scanf ("Sit2d%f%d %(0-9] ", &j, &1, &x, name); 


with input: 
011 56789 0123 56a72 


will assign 9 to j, 56 to i, 789.0 to x, skip 0123 and place the string 56\0 in 
name. The next call to getchar [see gete(3S)] will return a. Or: 


int i, j, s, e; char name[50]; 
(void) scanf ("Si %i %n%s%n", &1i, &J, &S, mame, &e); 


with input: 
0x11 Oxy johnson 


will assign 17to i, 0 toj, 6 to s, will place the string xy\0 in name, and will 
assign 8 toe. Thus, the length of nameise-s = 2. The next call to getchar 
[see gete(3S)] will return a blank. 


SEE ALSO 
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getc(3S), printf(3S), stdio(3S), strtod(3C), strtol(3C) 
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DIAGNOSTICS 
These functions return EOF on end of input and a short count for missing or & 
illegal data items. 
WARNINGS 
Trailing white space (including a new-line) is left unread unless matched in 
the control string. 
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NAME 
setbuf, setvbuf — assign buffering to a stream 


SYNOPSIS 
#include <stdio.h> 


void setbuf (stream, buf) 
FILE *stream; 
char *buf; 
int setvbuf (stream, buf, type, size) 
FILE *stream; 
char *buf; 
int type, size; 
DESCRIPTION 
setbuf may be used after a stream has been opened but before it is read or 
written. It causes the array pointed to by buf to be used instead of an auto- 
matically allocated buffer. If buf is the NULL pointer input/output will be 
completely unbuffered. 


Aconstant BUFSIZ, defined in the <stdio.h> header file, tells how big an 
array is needed: 
char buf (BUFSI2]; 


setvbuf may be used after a stream has been opened but before it is read or 
written. type determines how stream will be buffered. Legal values for 
type (defined in <stdio.h>) are: 


_IOFBF causes input/output to be fully buffered. 

_IOLBF causes output to be line buffered; the buffer will be flushed 
when a newline is written, the buffer is full, or input is 
requested. 

_IONBF causes input/output to be completely unbuffered. 


If buf is not the NULL pointer, the array it points to will be used for buffering, 
instead of an automatically allocated buffer. size specifies the size of the buf- 
fer to be used. The constant BUFSIZ in <stdio.h> is suggested as a good buf- 
fer size. If input/output is unbuffered, buf and size are ignored. 


By default, output to a terminal is line buffered and all other input/output is 
fully buffered. 


SEE ALSO 
fopen(3S), getc(3S), malloc(3C), putce(3S), stdio(3S) 


DIAGNOSTICS 
If an illegal value for type or size is provided, setvbuf returns a non-zero 


value. Otherwise, the value returned will be zero. 


NOTES 
Acommon source of error is allocating buffer space as an “automatic” variable 


in a code block, and then failing to close the stream in the same block. 
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NAME 


stdio — standard buffered input/output package 


SYNOPSIS 


#include <stdio.h> 
FILE *stdin, *stdout, *stderr; 


DESCRIPTION 
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The functions described in the entries of sub-class 3S of this manual consti- 
tute an efficient, user-level I/O buffering scheme. The in-line macros gete(3S) 
and pute(3S) handle characters quickly. The macros getchar and putchar, 
and the higher-level routines fgetc, fgets, fprintf, fputc, fputs, fread, 
fecanf, fwrite, gets, getw, printf, puts, putw, and scanf all use or act as if 
they use getc and pute; they can be freely intermixed. 


A file with associated buffering is called a stream and is declared to be a 
pointer to a defined type FILE. fopen(3S) creates certain descriptive data for 
a stream and returns a pointer to designate the stream in all further transac- 
tions. Normally, there are three open streams with constant pointers declared 
in the <stdio.h> header file and associated with the standard open files: 


stdin standard input file 
stdout standard output file 
stderr standard error file 


Aconstant NULL (0) designates a nonexistent pointer. 


An integer-constant EOF (—1) is returned upon end-of-file or error by most 
integer functions that deal with streams (see the individual descriptions for 
details). 


An integer constant BUFSIZ specifies the size of the buffers used by the partic- 
ular implementation. 


Any program that uses this package must include the header file of pertinent 
macro definitions, as follows: 


#include <stdio.h> 


The functions and constants mentioned in the entries of sub-class 3S of this 
manual are declared in that header file and need no further declaration. The 
constants and the following “functions” are implemented as macros (redeclara- 
tion of these names is perilous): gete, getchar, pute, putchar, ferror, feof, 
clearerr, and fileno. 


Output streams, with the exception of the standard error stream stderr, are 
by default buffered if the output refers to a file and line-buffered if the output 
refers to a terminal. The standard error output stream stderr is by default 
unbuffered, but use of freopen [see fopen(3S)] will cause it to become buf- 
fered or line-buffered. When an output stream is unbuffered, information is 
queued for writing on the destination file or terminal as soon as written; when 
it is buffered, many characters are saved up and written as a block. When it is 
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line-buffered, each line of output is queued for writing on the destination ter- 
minal as soon as the line is completed (that is, as soon as a new-line character 
is written or terminal input is requested). setbuf(3S) or setvbuf() in set- 
buf(3S) may be used to change the stream’s buffering strategy. 

SEE ALSO 
open(2), close(2), lseek(2), pipe(2), read(2), write(2), ctermid(3S), cuserid(3S), 
felose(3S), ferror(3S), fopen(3S), fread(3S), fseek(3S), getc(3S), gets(3S), 
popen(38), printf(3S), putc(3S), puts(3S), scanf(3S), setbuf(3S), system(3S), 
tmpfile(3S), tmpnam(3S), ungetc(3S) 

DIAGNOSTICS 
Invalid stream pointers will usually cause grave disorder, possibly including 
program termination. Individual function descriptions describe the possible 
error conditions. 
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NAME 
system — issue a shell command 


SYNOPSIS 
#include <stdio.h> 


int system (string) 
char *string; 

DESCRIPTION 
system causes the string to be given to sh(1) as input, as if the string had 
been typed as a command at a terminal. The current process waits until the 
shell has completed, then returns the exit status of the shell. 


FILES 
/oin/sh 
SEE ALSO 
sh(1), exec(2) 


DIAGNOSTICS 
system forks to create a child process that in turn exec’s /bin/sh in order to 
execute string. If the fork or exec fails, system returns a negative value and 
sets errno. 
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NAME 

tmpfile — create a temporary file 
SYNOPSIS 

#include <stdio.h> 

FILE +tmpfile () 


DESCRIPTION 
tmpfile creates a temporary file using a name generated by tmpnam(3S), 
and returns a corresponding FILE pointer. If the file cannot be opened, an 
error message is printed using perror(3C), and a NULL pointer is returned. 
The file will automatically be deleted when the process using it terminates. 
The file is opened for update (w+). 

SEE ALSO 
creat(2), unlink(2), fopen(3S), mktemp(3C), perror(3C), stdio(3S), tmpnam(3S) 
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NAME 
tmpnam, tempnam — create a name for a temporary file 


SYNOPSIS 
#include <stdio.h> 


char *tmpnam (s) 
char *8; 


char *tempnam (dir, pfx) 
char *dir, «pfx; 
DESCRIPTION 
These functions generate filenames that can safely be used for a temporary 
file. 


tmpnam always generates a filename using the path-prefix defined as 
P_tmpdir in the <stdio.h> header file. If s is NULL, tmpnam leaves its 
result in an internal static area and returns a pointer to that area. The next 
call to tmpnam will destroy the contents of the area. If s is not NULL, it is 
assumed to be the address of an array of at least L_tmpnam bytes, where 
L_tmpnam is a constant defined in <stdio.h>; tmpnam places its result in 
that array and returns s. 


tempnam allows the user to control the choice of a directory. The argument 
dir points to the name of the directory in which the file is to be created. If dir 
is NULL or points to a string that is not a name for an appropriate directory, 
the path-prefix defined as P_tmpdir in the <stdio.h> header file is used. If 
that directory is not accessible, tmp will be used as a last resort. This entire 
sequence can be up-staged by providing an environment variable TMPDIR in 
the user’s environment, whose value is the name of the desired temporary-file 
directory. 

Many applications prefer their temporary files to have certain favorite initial 
letter sequences in their names. Use the pfx argument for this. This argu- 
ment may be NULL or point to a string of up to five characters to be used as 
the first few characters of the temporary-filename. 


tempnam uses malloc(3C) to get space for the constructed filename, and 
returns a pointer to this area. Thus, any pointer value returned from temp- 
nam may serve as an argument to free [see malloc(3C)]. If tempnam can- 
not return the expected result for any reason, i.e. malloc(3C) failed, or none 
of the above mentioned attempts to find an appropriate directory was success- 
ful, a NULL pointer will be returned. 


NOTES : 
These functions generate a different filename each time they are called. 

Files created using these functions and either fopen(3S) or creat(2) are tem- 
porary only in the sense that they reside in a directory intended for temporary 
use, and their names are unique. It is the user’s responsibility to use 

unlink (2) to remove the file when its use is ended. 


SEE ALSO 
creat(2), unlink(2), fopen(3S), malloc(3C), mktemp(3C), tmpfile(3S) 


WARNINGS 
If called more than TMP_MAX times in a single process, these functions will 
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start recycling previously used names. (TMP_MAX is a constant defined in 
<stdio.h>.) 

Between the time a filename is created and the file is opened, it is possible for 

some other process to create a file with the same name. This can never hap- 

pen if that other process is using these functions or mktemp, and the 

filenames are chosen to render duplication by other means unlikely. 
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NAME 
ungete — push character back into input stream 


SYNOPSIS 
#include <stdio.h> 
int ungetc (c, stream) 
int c; 
FILE *stream; 
DESCRIPTION 
ungetc inserts the character c into the buffer associated with an input 
stream. That character, c, will be returned by the next gete(3S) call on that 
stream. ungetc returns c, and leaves the file stream unchanged. 


One character of pushback is guaranteed, provided something has already 
been read from the stream and the stream is actually buffered. 
If c equals EOF, ungetc does nothing to the buffer and returns EOF. 
fseek(3S) erases all memory of inserted characters. 

SEE ALSO 
fseek(8S), getc(3S), setbuf(38S), stdio(3S) 

DIAGNOSTICS 
ungetc returns EOF if it cannot insert the character. 


BUGS 
When stream is stdin, one character may be pushed back onto the buffer 
without a previous read statement. 
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NAME 
© vprintf, vfprintf, vsprintf — print formatted output of a varargs argument list 


SYNOPSIS 
#include <stdio.h> 
#include <varargs.h> 


int vprintf (format, ap) 
char *format; 
va_list ap; 


int vfprintf (stream, format, ap) 
FILE *stream; 

char *format; 

va_list ap; 


int vsprintf (s, format, ap) 
char *s, *format; 
va_list ap; 

DESCRIPTION 
vprintf, vfprintf, and vsprintf are the same as printf, fprintf, and sprintf 
respectively, except that instead of being called with a variable number of 
arguments, they are called with an argument list as defined by varargs(5). 


EXAMPLE 
The following demonstrates the use of vfprintf to write an error routine. 
@ #include <stdio.h> 
#include <varargs.h> 
* error should be called like 
* error(function_name, format, argl, arg2...)7 */ 
/*VARARGS*/ 
void 


error (va_alist) 


/* Note that the function_name and format arguments cannot be 
* separately declared because of the definition of varargs. */ 
va_dcl 
{ 

va_list args; 

char *fmt; 


va_start (args); 
/* print out name of function causing error */ 
(void) fprintf(stderr, "ERROR in %s: ", va_arg(args, char *)) 
fmt = va_arg(args, char *); 
/* print out remainder of message */ 
(void) vfprintf(stderr, fmt, args); 
@ va_end (args) ; 
(void) abort( ); 
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SEE ALSO 
printf(3S), varargs(5) 
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© NAME 


dis386 — disassemble Series 386 instructions 


SYNOPSIS 


char *dis386(addr, len_p) 
unsigned long addr; 
int *len_p; 


dis386_init(iread, dolook, do_Inums, xlate_name, 
xlate_local, oflag, Rflag, sflag) 

unsigned char (*iread)(); 

void (*dolook)0; 

void (*do_Inums)(); 

char *(*xlate_name)(); 

void (*xlate_local)(); 

int oflag, Rflag, sflag; 


DESCRIPTION 
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dis386 is a disassembler. dis386 returns a pointer to a string containing the 
disassembled instruction. dis386 in initialized with dis386_init. 


dis386 takes the following arguments: 


addr The of the address of the first byte of the instruction to be 
disassembled. 

len_p A pointer to an integer. dis386 stores the length of the 
string containing the disassembled instruction into the inte- 
ger. 

dis386_init takes the following arguments: 

iread A pointer to a routine to return actual bytes to be disassem- 


bled from the instruction space. iread takes an unsigned 
argument that is the address of the byte to be read. The first 
call passed this address to dis386. Subsequent calls increase 
the address by 1. 


dolook Used to disassamble jump tables. dolook gives the calling 
program the address at which dis386 is disassembling so 
that the calling program can print the label if appropriate. 
dolook takes an unsigned argument that specifies where the 
label might be. 


do_lnums Used to disassemble jump tables. do_lnums gives the calling 
program the line numbers at which dis386 is disassembling 
so that the calling program can print the line numbers if 
appropriate. do_Inums does not take any arguments. 


xlate_name A pointer to a routine to return the symbolic name of an 
absolute address. If a NULL pointer is passed as the routine 
to translate addresses, no translation is done. xlate_name 
takes an unsigned argument that specifies the symbol 
address. 


xlate_local A pointer to a routine to return the symbolic name of local 
symbols, function arguments, and arrays. xlate_local can 
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take any of the following arguments: the offset from the 
base register (type long), the register number (type int), or a 
pointer to a pointer to a char (type char**). 


oflag Tf oflag is 0, the dis386 output is hexadecimal; if oflag is 1, 
the output is octal. 
Rflag If Rflag is 0, 32-bit mode is specified; if Rflag is 1, 16-bit 


mode is specified. 


sflag A value of 0 specifies no symbolic diassembly; a value of 1 
specifies symbolic diassembly, unless either xlate_name or 
xlate_local are not NULL. 


The routine to return bytes from the instruction space should be declared as 
follows: 


unsigned char iread(addr) 
unsigned int addr; 


It should return the byte at the address in the instruction space given by 
addr. 


The routine to return the symbolic address of an absolute address should be 
declared as follows: 
char *xlate_name (addr) 
unsigned int addr; 


It should return a pointer to a static buffer holding the symbolic name of the 
location given by addr. If no name is found, a NULL pointer should be 
returned. 


The routine to return the symbolic name of a local variable should be declared 
as follows: 


void xlate_local(val, regno, sp) 
long val; 
int regno; 
char **sp; 


It should write into the string pointed to by sp the symbolic name of the local 
variable with offset val from register regno. If no name is found, a NULL 
pointer should be returned. 


dis$86 returns a pointer to a static character string that is the disassembly of 
the given address, and also stores the length of the instruction in the integer 
pointed to by len_p. 
This routine is found in the Sequent library, designated in 1d(1) or ec(1) by 
-Iseq. 

SEE ALSO 
dis(1) 

NOTES 
This is a Sequent library routine. To use it, specify the -Iseq option to link 


with the Sequent library. Since this is a Sequent extension, code using this 
routine may not be portable to other systems. 
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NAME 

getgeombyname — get disk geometry by name 
SYNOPSIS 

#include <sys/zdc.h> 

#include <diskinfo.h> 


struct geomtab * 
getgeombyname(disktype) 
char *disktype; 

DESCRIPTION 
getgeombyname takes a disk type name (e.g., m2333k) and returns a struc- 
ture describing its geometry information. All information is obtained from 
files in the directory /etc/diskinfo which end in the suffix.geom. Each of 
these files contains the geometry information for one disk type. See 
/usr/include/diskinfo.h for a description of the fields in struct geomtab. 


SEE ALSO 
diskinfo(4) 

NOTES 
This is a Sequent library routine. To use it, specify the -Iseq option to link 
with the Sequent library. Since this is a Sequent extension, code using this 
routine may not be portable tc other systems. 
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NAME 


addmntent, endmntent, getmntent, hasmntopt, setmntent — get file system 
descriptor file entry 


SYNOPSIS 


#include <stdio.h> 
#include <sys/types.h> 
#include <mntent.h> 


int addmntent(filep, mnt) 

FILE *filep; 

struct mntent *mnt; 

int endmntent(filep) 

FILE *filep; 

char *hasmntopt(mnt, opt) 
struct mntent *mnt; 

char *opt; 

struct mntent *getmntent(filep) 
FILE *filep; 


FILE *setmntent(filep, type) 
char *filep; 
char *type; 


DESCRIPTION 


FILES 
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These routines are used to access the file system description file /etc/fstab. 
They are also used to access and update the mounted file system description 
file /etc/mnttab. 


setmntent opens a file system description file and returns a file pointer which 
can then be used with getmntent, addmntent, or endmntent. The type 
argument is the same as in fopen(3). getmntent reads the next line from 
filep and returns a pointer to an object with the following structure contain- 
ing the broken-out fields of a line in the filesystem description file. The struc- 
ture is defined in <mntent.h>. The fields have meanings described in fstab(4). 


struct mntent { 


char *mnt_fsname; /* file system name */ 

char *mnt_dir; /* file system path prefix */ 
char *mnt_type; /* 4.2, nfs, or ignore */ 
char *mnt_opts; /* ro, quota, etc. */ 

time_t mnt_time; /* mount time (mnttab only) */ 


ye 


addmntent adds the mntent structure mnt to the end of the open file filep. 
Note that filep has to be opened for writing if this is to work. hasmntopt 
scans the mnt_opts field of the mntent structure mnt for a substring that 
matches opt. It returns the address of the substring if a match is found, 0 
otherwise. endmntent closes the file. 


etc/fstab 
/etc/mnttab 
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SEE ALSO 
fstab(4), mnttab(4) 


DIAGNOSTICS 
ANULL pointer is returned on EOF or error. 


NOTES 
These are Sequent library routines. To use them, specify the -Iseq option to 
link with the Sequent library. Since these are Sequent extensions, code using 
these routines may not be portable to other systems. 


BUGS 
The returned mntent structure points to static information that is overwrit- 
ten in each call. 
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NAME 
getpseudotty — get pseudo terminals 
SYNOPSIS 
int getpseudotty(slave, master) 
char **slave, **master; 


DESCRIPTION 
getpseudotty locates an available pseudo terminal device pair and returns 
an open file descriptor of the master side opened for reading and writing. The 
pathname of the pair is returned through the slave and master arguments. 


If getpseudotty is unable to find any available pseudo terminals, it returns 
-l1. 

FILES 
/dev/getpty 

SEE ALSO 
streampty(7) 

NOTES 
This is a Sequent library routine. To use it, specify the -Iseq option to link 
with the Sequent library. Since this is a Sequent extension, code using this 
routine may not be portable to other systems. 

BUGS 
The return values of getpseudotty point to static data whose contents are 
overwritten by each call. 
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NAME 


getscsiinfo, getscsimatch — get scsiinfo structure 


SYNOPSIS 


#include <sys/zdc.h> 
#include <diskinfo.h> 


struct scsiinfo * 
getscsimatch(vendor, product) 
char *vendor, *product; 


struct scsiinfo * 


getscsiinfo() 


DESCRIPTION 


@ SEE ALSO 


NOTES 
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getscsimatch takes the vendor and product names of the disk as returned by 
the SCSI INQUIRY command and locates the .scsi (e.g., wren3.scsi) file in 
/etc/diskinfo with matching vendor and product strings. It then returns the 
data in this file in a scsiinfo structure. getscsiinfo finds the next .scsi file in 
/etc/diskinfo and creates and returns a scsiinfo structure built from that file. 
On error or when there are no more .scsi files in the directory, NULL is 
returned. This information is used by the format program. Note that the 
vendor string must be padded with blanks to be 8 characters long, and the 
product string must be padded to 16 characters, as this is the way the strings 
are returned by the SCSI INQUIRY command. See /usr/include/diskinfo.h 
for a description of the fields in struct scsiinfo. 


diskinfo(4) format(1M) 


These are Sequent library routines. To use them, specify the -lseq option to 
link with the Sequent library. Since this is a Sequent extension, code using 
this routine may not be portable to other systems. 
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NAME 


getusclk, usclk_init — get/init microsecond clock 


SYNOPSIS 


#include <usclke.h> 
void usclk_initQ) 


usclk_t getusclk() 
usclk_t GETUSCLK() 


DESCRIPTION 


The Sequent microsecond clock (usclk) is a programmatically accessible 32-bit 
up-counter which increments in real (wall clock) time at a one microsecond 
per tick rate. It is reset to zero at power-up and free runs thereafter. There is 
no notification as the clock rolls over its maximum value and returns to zero. 


usclk_init maps the microsecond clock into process address space, making it 
accessible for subsequent use. usclk_init should be called only once and must 
precede the first call to getuselk . 


getusclk returns the current 32-bit microsecond clock value. 


GETUSCLK is a cpp macro which accesses the microsecond clock without the 
overhead of a function call. For this reason this is the preferred method for 
referencing the microsecond clock. 


The routines described here are in /usr/lib/libseq.a. They are linked into a 
program using the -Iseq option in the ce or ld command line. GETUSCLK is 
defined in the usclkc.h header file. 


SEE ALSO 


usclk(7) 


DIAGNOSTICS 


NOTES 
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usclk_init fails with exit status 1 ifit cannot open, map, or access the 
microsecond clock device. 


The mapping established by usclk_init is inherited by forked processes. 
The call overhead for GETUSCLK is nil on Symmetry. 


These are Sequent library routines. To use them, specify the -lseq option to 
link with the Sequent library. Since these are Sequent extensions, code using 
these routines may not be portable to other systems. 
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NAME 


GETZDINFO(3SEQ) 


getzdinfo, getzdinfobyname — get zdinfo structure 


SYNOPSIS 


#include <sys/zdc.h> 
#include <diskinfo.h> 


struct zdinfo * 
getzdinfobyname(disktype) 
char *disktype; 


struct zdinfo * 
getzdinfo() 


DESCRIPTION 


getzdinfobyname takes a disk type name (e.g., m2333k) and returns a struc- 
ture containing the disk type name and the ZDC channel configuration data 
for that disk type. All information is obtained from files in the directory 
/etc/diskinfo which end in the suffix .zd. Each of these files contains the 
channel configuration data for one disk type. getzdinfo finds the next ’.zd’ 
file in /etc/diskinfo and creates and returns a zdinfo structure built from that 
file. On error or when there are no more .zd files in the directory, NULL is 
returned. This information is provided primarily for use by the format pro- 
gram. See /usr/include/diskinfo.h and /usr/include/sys/zdc.h for a descrip- 
tion of the fields in struct zdinfo. 


SEE ALSO 


diskinfo(4) format(1M) 


NOTES . 
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These are Sequent library routines. To use them, specify the -Iseq option to 
link with the Sequent library. Since this is a Sequent extension, code using 
this routine may not be portable to other systems. 
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NAME 
initgroups — initialize group access list 

SYNOPSIS 
initgroups(name) 
char *name; 

DESCRIPTION 
initgroups reads through the group file and sets up, using the set- 
groups(2seq) call, the supplementary group access list for the user specified 
in name. Only the first NGROUPS_MAX [see intro(2)] entries are used if the 
user is in too many groups. 


FILES 
/ete/group 


SEE ALSO 
intro(2), setgroups(2seq) 

DIAGNOSTICS 
initgroups returns 1 if it was not invoked by the superuser and 0 if success- 
ful. 


NOTES 
This is a Sequent library routine. To use it, specify the -lseq option to link 
with the Sequent library. Since this is a Sequent extension, code using this 
routine may not be portable to other systems. 


BUGS 


initgroups uses the routines based on getgrent(3). If the invoking program 
uses any of these routines, the group structure is overwritten in the call to 


initgroups. 
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NAME 
nblocks — calculate number of blocks and indirect blocks 


SYNOPSIS 
unsigned long nblocks(size, bsize, fsize) 
unsigned long size, bsize, fsize; 

DESCRIPTION 
nblocks returns the total number of DEV_BSIZE blocks (typically 512 bytes) 
a file of size bytes would use on a filesystem. The total includes single indi- 
rect, double indirect and triple indirect blocks. The bsize parameter is the 
block size of the filesystem. The fsize parameter is currently ignored. 


Partial blocks are counted in block-size chunks. 


NOTES 
This is a Sequent library routine. To use it, specify the -Iseq option to link 
with the Sequent library. Since this is a Sequent extension, code using this 
routine will not be portable to other systems. 


BUGS 
Large sparce files may return an incorrect number of blocks. 
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NAME 
offline_all — take all but one active processor off line 


SYNOPSIS 
int offline_all() 
DESCRIPTION 


The offline_all routine takes all processors off line except the lowest-num- 
bered active processor (normally processor 0). 


SEE ALSO 
tmp_ctl(2), tmp_affinity(2) 

DIAGNOSTICS 
Returns 1 if successful, 0 otherwise. If unsuccessful, use tmp_ctl(2) to get the 
status of the remaining processors. 

NOTES 
This is a Sequent library routine. To use it, specify the -Iseq option to link 
with the Sequent library. Since this is a Sequent extension, code using this 
routine may not be portable to other systems. 
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NAME 
read_constab — read constab entries into a structure 


SYNOPSIS 
#include <constab.h> 


read_constab(table, last_entry) 
struct constab **table; 
struct constab **last_entry; 


DESCRIPTION 
The file /etc/constab contains the results of virtual device bindings which 
result from invocations of the devbuild(1M) command. The contents of this 
file may be read into a convenient structure through the read_constab() rou- 
tine. Upon successful completion of the routine, table points to a dynamically 
allocated table of struct constabstructures, and last_entry points to the 
last entry of the table. See the file /usr/include/constab.h for a definition of 
struct constab. 


SEE ALSO 
devbuild (1M), constab (4) 

NOTES 
This is a Sequent library routine. To use it, specify the -Iseq option to link 
with the Sequent library. Since this is a Sequent extension, code using this 
routine may not be portable to other systems. 
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NAME 
valloc — aligned memory allocator 


SYNOPSIS 
char *valloc(size) 
unsigned size; 

DESCRIPTION 
valloc allocates size bytes aligned on a page boundary. It is implemented by 
calling malloc(3) with a slightly larger request, saving the true beginning of 
the block allocated, and returning a properly aligned pointer. 

DIAGNOSTICS 


valloc returns a null pointer (0) if there is no available memory or if the 

arena has been detectably corrupted by storing outside the bounds of a block. 
NOTES 

This is a Sequent library routine. To use it, specify the -lseq option to link 

with the Sequent library. Since this is a Sequent extension, code using this 

routine may not be portable to other systems. 


BUGS 
vfree isn’t implemented. 
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NAME 
assert — verify program assertion 
SYNOPSIS 
#include <assert.h> 
assert (expression) 
int expression; 
DESCRIPTION 
This macro is useful for putting diagnostics into programs. When it is exe- 
cuted, if expression is false (zero), assert prints 
Assertion failed: expression, filexyz, linennn 


on the standard error output and aborts. In the error message, xyz is the 
name of the source file and nnn the source line number of the assert state- 
ment. 


Compiling with the preprocessor option -DNDEBUG [see cpp(1)], or with the 
preprocessor control statement #define NDEBUG ahead of the #include 
<assert.h>statement, will stop assertions from being compiled into the pro- 
gram. 

SEE ALSO 
epp(1), abort(3C) 

WARNINGS 
Since assert is implemented as a macro, the expression may not contain any 
string literals. 
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NAME 


crypt — password and file encryption functions 


SYNOPSIS 


ce [flag ...] file ... -lerypt 


char *crypt (key, salt) 
char +key, *salt; 


void setkey (key) 
char *key; 


void encrypt (block, flag) 
char *block; 
int flag; 


char *des_crypt (key, salt) 
char +key, *salt; 


void des_setkey (key) 
char +key; 


void des_encrypt (block, flag) 
char *block; 

int flag; 

int run_setkey (p, key) 

int p[2]; 

char *key; 

int run_crypt (offset, buffer, count, p) 
long offset; 

char *buffer; 

unsigned int count; 

int p[2]; 


int crypt_close(p) 
int p[2]; 


DESCRIPTION 
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des_crypt is the password encryption function. It is based on a one way 
hashing encryption algorithm with variations intended (among other things) 
to frustrate use of hardware implementations of a key search. 


key is a user’s typed password. salt is a two-character string chosen from the 
set [a-zA-Z0-9,]; this string is used to perturb the hashing algorithm in one of 
4096 different ways, after which the password is used as the key to encrypt 
repeatedly a constant string. The returned value points to the encrypted pass- 
word. The first two characters are the salt itself. 


The des_setkey and des_encrypt entries provide (rather primitive) access to 
the actual hashing algorithm. The argument of des_setkey is a character 
array of length 64 containing only characters with numerical values of 0 and 
1. If this string is divided into groups of 8, the low-order bit in each group is 
ignored; this gives a 56-bit key which is set into the machine. This is the key 
that will be used with the hashing algorithm to encrypt the string block with 
the function des_encrypt. : 


CRYPT(3X) DYNIX/ptx 


The argument to the des_encrypt entry is a character array of length 64 con- 
taining only the characters with numerical value 0 and 1. The argument 
array is modified in place to a similar array representing the bits of the argu- 
ment after having been subjected to the hashing algorithm using the key set 
by des_setkey. If edflag is zero, the argument is encrypted; if non-zero, it is 
decrypted. 

Note that decryption is not provided in the international version of crypt(3X). 
If decryption is attempted with the international version of des_encrypt, an 
error message is printed. 


crypt, setkey, and encrypt are front-end routines that invoke des_erypt, 
des_setkey, and des_encrypt respectively. 


The routines run_setkey and run_crypt are designed for use by applications 
that need cryptographic capabilities [such as ed(1) and vi(1)] that must be 
compatible with the erypt(1) user-level utility. run_setkey establishes a 
two-way pipe connection with crypt(1), using key as the password argument. 
run_crypt takes a block of characters and transforms the cleartext or cipher- 
text into their ciphertext or cleartext using crypt(1). offset is the relative 
byte position from the beginning of the file that the block of text provided in 
block is coming from. count is the number of characters in block, and con- 
nection is an array containing indices to a table of input and output file 
streams. When encryption is finished, crypt_close is used to terminate the 
connection with erypt(1). 


run_setkey returns -1 if a connection with crypt(1) cannot be established. 
This will occur on international versions of UNIX where crypt(1) is not avail- 
able. If a null key is passed to run_setkey, 0 is returned. Otherwise, 1 is 
returned. run_crypt returns -1 if it cannot write output or read input from 
the pipe attached to crypt. Otherwise it returns 0. 


DIAGNOSTICS 
In the international version of crypt(3X), a flag argument of 1 to 
des_encrypt is not accepted, and an error message is printed. 


SEE ALSO 
crypt(1), login(1), passwd(1), getpass(3C), passwd(4) 

WARNINGS 
The return value in crypt points to static data that are overwritten by each 
call. 
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NAME 
curses — terminal screen handling and optimization package 
TABLE OF CONTENTS 
Page 
SYNOPSIS 1 
- compiling information 
- summary of parameters used by curses routines 
- alphabetical list of curses routines showing 
their parameters, with a key to the section of 
ROUTINES in which they are discussed. 
DESCRIPTION 6 
- An overview of how curses routines should be used 
ROUTINES 8 
- Each routine is described in the appropriate section: 
Section 1: Overall Screen Manipulation 9 
Section 2: Window and Pad Manipulation 10 
Section 3: Output 12 
Section 4: Input 16 
Section 5: Output Options Setting 19 
Section 6: Input Options Setting 20 
Section 7: Environment Queries 22 
Section 8: Color Manipulation 22 
Section 9: Soft Labels 23 
Section 10: Low-Level curses Access 24 
Section 11: Terminfo-Level Manipulations 26 
Section 12: Termcap Emulation 29 
Section 13: Miscellaneous 29 
Section 14: Use of curser 29 
Section 15: Obsolete Calls 30 
ATTRIBUTES 30 
COLORS 30 
FUNCTION KEYS 31 
LINE GRAPHICS 33 
SYNOPSIS 
ce [flag ...] file ... -lcurses [library ...] 
#include <curses.h> (automatically includes <stdio.h>, 


<termio.h>, and <unctrl.h>). 


The parameters in the following summary are the arguments used by the 
curses library routines: they are not global variables. All routines return 
the int values ERR or OK unless it is stated otherwise in the ROUTINES 
section. Routines that return pointers always return NULL on error. 
(ERR, OK, and NULL are all defined in <curses.h>.) The summary ee 
both the variable definitions and the routine names. 
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VARIABLE DEFINITIONS 

bool bf; 

char **area,*boolnameg| ], *boolcodes[ J, *boolfnames| ], *bp; 
char *cap, *capname, codename[2], erasechar, *filename, *fmt; 
char *keyname, killchar, *label, *longname; 

char *name, *numnames[], *numcodes[ ], *numfnames[]; 
char *slk_label, «str, *strnames[], *strcodes[], *strfnames[ J; 
char *term, *tgetstr, *tigetstr, *tgoto, *tparm, *type; 
chtype attrs, ch, horch, vertch; 

FILE *infd, *outfd; 

int begin_x, begin_y, begline, bot, c, col, count; 

int dmaxcol, dmaxrow, dmincol, dminrow, *errret, fildes; 
int (*init( )), labfmt, labnum, line; 

int ms, ncols, new, newcol, newrow, nlines, numlines; 

int oldcol, oldrow, overlay; 

int pl, p2, p9, pmincol, pminrow, (*putc( )), row; 

int smaxcol, smaxrow, smincol, sminrow, start; 

int tenths, top, visibility, x, y; 

short pair, color, f, r, g, b; 

SCREEN *new, *newterm, *set_term; 

TERMINAL *cur_term, *nterm, *oterm; 

va_list varglist; 

WINDOW ‘*curscr, *dstwin, *initscr, *newpad, *newwin, *orig; 
WINDOW *pad, *srewin, *stdscr, *subpad, *subwin, *win; 


ROUTINE NAMES 

addch(ch) 

addstr(str) 

attroff(attrs) 

attron(attrs) 

attrset(attrs) 

baudrate() 

beep() 

box(win, vertch, horch) 

can_change_color() 

cbreak() 

clear{) 

clearok(win, bf) 

clrtobot() 

elrtoeol() 

color_content(color, &r, &g, &b) 

copywin(srewin, dstwin, sminrow, smincol, 
dminrow, dmincol, dmaxrow, dmaxcol, overlay) 

curs_set(visibility) 

def_prog_mode() 
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ROUTINE NAMES 
def_shell_mode() 
del_curterm(oterm) 
delay_output(ms) 
delch() 

deleteln() 
delwin(win) 
doupdate() 
draino(ms) 

echo() 
echochar(ch) 
endwin() 

erase() 
erasechan ) 
filter() 

flash() 

flushinp() 
garbagedlines(win, begline, numlines) 
getbegyx(win, y, x) 
getch() 
getmaxyx(win, y, x) 
getstr(str) 
getsyxly, x) 
getyx(win, y, x) 
halfdelay(tenths) 
has_colors() 
has_ic() 

has_il() 

idlok(win, bf) 
inch() 
init_color(color, r, g, b) 
init_pair(pair, f, b) 
initser() 

insch(ch) 
insertln() 
intrflush(win, bf) 
isendwin() 
keyname(c) 
keypad(win, bf) 
killchar() 
leaveok(win, bf) 
longname() 
meta(win, bf) 
movety, x) 
mvaddch\y, x, ch) 
mvaddstr(y, x, str) 
mveur(oldrow, oldcol, newrow, newcol) 
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ROUTINE NAMES 

mvdelch(y, x) 

mvgetch(y, x) 

mvgetstr(y, x, str) 

mvinch(y, x) 

mvinsch(y, x, ch) 

mvprintw(y, x, fmt [, arg...]) 

mvscanw\y, x, fmt [, arg...]) 

mvwaddch(win, y, x, ch) 

mvwaddstr(win, y, x, str) 

mvwdelch(win, y, x) 

mvwegetch(win, y, x) 

mvwegetstr(win, y, x, str) 

mvwin(win, y, x) 

mvwinch(win, y, x) 

mvwinsch(win, y, x, ch) 

mvwprintw(win, y, x, fmt [, arg...]) 

mvwscanw(win, y, x, fmt [, arg...]) 

napms(ms) 

newpad(nlines, ncols) 

newterm(type, outfd, infd) 

newwin(nlines, ncols, begin_y, begin_x) 

ni() 

nocbreak() 

nodelay(win, bf) 

noecho( ) 

nonl() 

noraw() 

notimeout(win, bf) 

overlay(srewin, dstwin) 

overwrite(srcwin, dstwin) 

pair_content(pair, &f, &b) 

pechochar(pad, ch) 

pnoutrefresh(pad, pminrow, pmincol, sminrow, 
smincol, smaxrow, smaxcol) 

prefresh(pad, pminrow, pmincol, sminrow, 
smincol, smaxrow, smaxcol) 

printw(fmt [, arg...]) 

putp(str) 

raw() 

refresh() 

reset_prog_mode() 

reset_shell_mode() ~ 

resetty() 

restartterm(term, fildes, errret) 

ripoffline(line, init) 


savetty() 
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ROUTINE NAMES 
scanw/(fmt [, arg...]) 
scr_dump(filename) 
ser_init(filename) 
scr_restore(filename) 
scroll(win) 

scrollok(win, bf) 
set_curterm(nterm) 
set_term(new) 
setscrreg(top, bot) 
setsyx(y, x) 
setupterm(term, fildes, errret) 
slk_attrofifattrs) 
slk_attron(attrs) 
slk_attrset(attrs) 
slk_clear() 

slk_init(fmt) 
slk_labeldabnum) 
slk_noutrefresh() 
slk_refresh() 
slk_restore() 
slk_set(labnum, label, fmt) 
slk_touch() 

standend() 

standout() 

start_color() 

subpad(orig, nlines, ncols, begin_y, begin_x) 
subwin(orig, nlines, ncols, begin_y, begin_x) 
tgetent(bp, name) 
tgetflag(codename) 
tgetnum(codename) 
tgetstr(codename, area) 
tgoto(cap, col, row) 
tigetflag(capname) 
tigetnum(capname) 
tigetstr(capname) 
touchline(win, start, count) 
touchwin(win) 

tparm(str, pl, p2, ..., p9) 
tputs(str, count, putc) 
traceoff() 

traceon() 
typeahead(fildes) 
unctrl(c) 

ungetch(c) 

vidattr(attrs) 
vidputs(attrs, putc) 
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ROUTINE NAMES 
vwprintw(win, fmt, varglist) 
vwscanw(win, fmt, varglist) 
waddch(win, ch) 
waddstr(win, str) 
wattroff(win, attrs) 
wattron(win, attrs) 
wattrset(win, attrs) 
welear(win) 
welrtobot(win) 
welrtoeol(win) 
wdelch(win) 
wdeleteln(win) 
wechochar(win, ch) 
werase(win) 

wegetch(win) 

weetstr(win, str) 
winch(win) 

winsch(win, ch) 
winsertIn(win) 
wmove(win, y, x) 
wnoutrefresh(win) 
wprintw(win, fmt [, arg...]) 
wrefresh(win) 
wscanw(win, fmt [, arg...]) 
wsetscrreg(win, top, bot) 
wstandend(win) 
wstandout(win) 


DESCRIPTION 
The curses routines give the user a terminal-independent method of updating 
screens with reasonable optimization. 


The file <curses.h> must be included at the beginning of programs that use 
any curses routines. In addition, the routine initscr() or newterm() must be 
called before any of the other routines that deal with windows and screens are 
used. (Three exceptions are noted where they apply.) The routine endwin() 
must be called before exiting. To get character-at-a-time input without echo- 
ing (most interactive, screen-oriented-programs want this), after calling 
initscr() you should call “ecbreak(); noecho();” Most programs would addi- 
tionally call “nonl(); intrflush (stdscr, FALSE); keypad (stdscr, TRUE);”. 


Before a curses program is run, a terminal’s tab stops should be set and its ini- 
tialization strings, if defined, must be output. To do this, execute tput init 
after the shell environment variable TERM has been set and exported. For 
further details, see profile(4), tput(1), and the "Tabs and Initialization" subsec- 
tion of terminfo(4). 


The curses library contains routines that manipulate data structures called 
windows that can be thought of as two-dimensional arrays of characters repre- 
senting all or part of a terminal screen. A default window called stdscr is 
supplied, which is the size of the terminal screen. Others may be created with 
newwin(). Windows are referred to by variables declared as WINDOW *; the 
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type WINDOW is defined in <curses.h> to be a structure. These data struc- 
tures are manipulated with routines described below, among which the most 
basic are move() and addch(). (More general versions of these routines are 
included, with names beginning with w, allowing you to specify a window. 

The routines not beginning with w usually affect stdscr.) Then refresh() is 
called, telling the routines to make the user’s terminal screen look like stdser. 
The characters in a window are actually of type chtype, defined in 
<curses.h>, so that other information about the character may also be stored 
with each character. 


Special windows called pads may also be manipulated. These are windows 
which are not constrained to the size of the screen and whose contents need 
not be displayed completely. See the description of newpad( ) under "Window 
and Pad Manipulation” for more information. 


In addition to drawing characters on the screen, video attributes may be 
included which cause the characters to be underlined or shown in reverse 
video on terminals that support such display enhancements. Line drawing 
characters may be specified to be output. On input, curses is also able to 
translate arrow and function keys that transmit escape sequences into single 
values. The video attributes, line drawing characters, and input values use 


names, defined in <curses.h>, such as A_LREVERSE, ACS_HLINE, and 
KEY_LEFT. 


Routines that manipulate color on color alphanumeric terminals are new in 
this release of curses. To use these routines start_color() must be called, 
usually right after initser(). Colors are always used in pairs (referred to as 
color-pairs). A color-pair consists of a foregound color (for characters) and a 
background color (for the field the characters are displayed on). A program- 
mer initializes a color-pair with the routine init_pair(). After it has been ini- 
tialized, COLOR_PAIR(n), a macro defined in <curses.h>, can be used in the 
same ways other video attributes can be used. Ifa terminal is capable of rede- 
fining colors the programmer can use the routine init_color() to change the 
definition of a color. The routines has_color() and can_change_color() 
return TRUE or FALSE, depending on whether the terminal has color capabili- 
ties and whether the user can change the colors. The routine color_con- 
tent() allows a user to identify the amounts of red, green, and blue compo- 
nents in an initialized color. The routine pair_content() allows a user to find 
out how a given color-pair is currently defined. 


curses also defines the WINDOW * variable, curser, which is used only for cer- 
tain low-level operations like clearing and redrawing a garbaged screen. 
curser can be used in only a few routines. If the window argument to 
clearok() is curser, the next call to wrefresh() with any window will cause 
the screen to be cleared and repainted from scratch. If the window argument 
to wrefresh() is curser, the screen is immediately cleared and repainted 
from scratch. This is how most programs would implement a “repaint-screen” 
function. More information on using curser is provided where its use is 
appropriate. 


The environment variables LINES and COLUMNS may be set to override ter- 
minfo’s idea of how large a screen is. These may be used in an AT&T Tele- 
type 5620 layer, for example, where the size of a screen is changeable. 
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will check for a local terminal definition before checking in the standard place. 
For example, if the environment variable TERM is set to att4425, then the 
compiled terminal definition is found in /usr/lib/terminfo/a/att4425. (Thea 
is copied from the first letter of att4425 to avoid creation of huge directories.) 
However, if TERMINFO is set to S$HOME/myterms, curses will first check 
$HOME/myterms/a/att4425, and, if that fails, will then check /usr/lib/ter- 
minfo/a/att4425. This is useful for developing experimental definitions or 
when write permission on /usr/lib/terminfo is not available. 


The integer variables LINES and COLS are defined in <curses.h>, and will be 
initialized by initser() with the size of the screen. (For more information, see 
the subsection "Terminfo-Level Manipulations”.) The integer variables 
COLORS and COLOR_PAIRS are also defined in <curses.h> and contain, 
respectively, the maximum number of colors and color-pairs the terminal can 
support. They are initialized by start_color(). The constants TRUE and 
FALSE have the values 1 and 0, respectively. The constants ERR and OK are 
returned by routines to indicate whether the routine successfully completed. 
These constants are also defined in <curses.h>. 


ROUTINES 
Many of the following routines have two or more versions. The routines pre- 
fixed with w require a window argument. The routines prefixed with p 
require a pad argument. Those without a prefix generally use stdscr. 


If the environment variable TERMINFO is defined, any program using curses © 


The routines prefixed with mv require y and x coordinates to move to before 
performing the appropriate action. The mv() routines imply a call to move() 
before the call to the other routine. The window argument is always specified 
before the coordinates. y always refers to the row (of the window), and x 
always refers to the column. The upper left corner is always (0,0), not (1,1). 
The routines prefixed with mvw take both a window argument and y and x 
coordinates. 


In each case, win is the window affected and pad is the pad affected. (win and 
pad are always of type WINDOW *.) Option-setting routines require a 
boolean flag bf with the value TRUE or FALSE. (bf is always of type bool.) 

The types WINDOW, bool, and chtype are defined in <curses.h>. See the 
SYNOPSIS for a summary of what types all variables are. 


All routines return either the integer ERR or the integer OK, unless otherwise 
noted. Routines that return pointers always return NULL on error. 


Sometimes the description of a routine refers to a second routine. Ifthe rou- 
tine referred to is prefixed with a w, then you should assume that other ver- 
sions of the second routine behave similarly. For example, the description of 
initser() refers to wrefresh(). This implies that the same result will occur if 
refresh() is called. 
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WINDOW *initscr() 
The first routine called should almost always be initser(). (The 
exceptions are slk_init(), filter(), and ripoffline().) This will 
determine the terminal type and initialize all curses data struc- 
tures. initser() also arranges that the first call to wrefresh() will 
clear the screen. If errors occur, initser() will write an appropri- 
ate error message to standard error and exit; otherwise, a pointer 
to stdscr is returned. If the program wants an indication of error 
conditions, newterm() should be used instead of initser( ). 
initser() should only be called once per application. 


endwin() A program should always call endwin() before exiting or escaping 
from curses mode temporarily, to do a shell escape or system (3S) 
call, for example. This routine will restore tty(7) modes, move the 
cursor to the lower left corner of the screen and reset the terminal 
into the proper non-visual mode. To resume after a temporary 
escape, call wrefresh() or doupdate( ). 

isendwin() 
Returns TRUE if endwin() has been called without any subse- 
quent calls to wrefresh(). 


SCREEN *newterm(type, outfd, infd) 
A program that outputs to more than one terminal must use 
: newterm() for each terminal instead of initser(). A program that 


® Section 1: Overall Screen Manipulation 


wants an indication of error conditions, so that it may continue to 
run in a line-oriented mode if the terminal cannot support a screen- 
oriented program, must also use this routine. newterm() should 
be called once for each terminal. It returns a variable of type 
SCREEN* that should be saved as a reference to that terminal. 
The arguments are the type of the terminal to be used in place of 
the environment variable TERM; outfd, a stdio(3S) file pointer for 
output to the terminal; and infd, another file pointer for input from 
the terminal. When it is done running, the program must also call 
endwin() for each terminal being used. If newterm() is called 
more than once for the same terminal, the first terminal referred to 
must be the last one for which endwin() is called. 

SCREEN *set_term(new) 
This routine is used to switch between different terminals. The 
screen reference new becomes the new current terminal. A pointer 
to the screen of the previous terminal is returned by the routine. 
This is the only routine which manipulates SCREEN pointers; all 
other routines affect only the current terminal. 
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Section 2: Window and Pad Manipulation 

refresh() 

wrefresh (win) 
These routines (or prefresh(), pnoutrefresh(), wnoutrefresh(), 
or doupdate( )) must be called to write output to the terminal, as 
most other routines merely manipulate data structures. 
wrefresh() copies the named window to the physical terminal 
screen, taking into account what is already there in order to mini- 
mize the amount of information that’s sent to the terminal (called 
optimization). refresh() does the same thing, except it uses stdscr 
as a default window. Unless leaveok() has been enabled, the phys- 
ical cursor of the terminal is left at the location of the window’s 
cursor. The number of characters output to the terminal is 
returned. 


Note that refresh() is a macro. 


wnoutrefresh(win) 

doupdate() 
These two routines allow multiple updates to the physical terminal 
screen with more efficiency than wrefresh() alone. How this is 
accomplished is described in the next paragraph. 


curses keeps two data structures representing the terminal screen: 
a physical terminal screen, describing what is actually on the 
screen, and a virtual terminal screen, describing what the program- 
mer wants to have on the screen. wrefresh() works by first calling 
wnoutrefresh(), which copys the named window to the virtual 
screen, and then by calling doupdate( ), which compares the vir- 
tual screen to the physical screen and does the actual update. If 
the programmer wishes to output several windows at once, a series 
of calls to wrefresh( ) will result in alternating calls to 
wnoutrefresh() and doupdate(), causing several bursts of output 
to the screen. By first calling wnoutrefresh() for each window, it 
is then possible to call doupdate() once, resulting in only one 
burst of output, with probably fewer total characters transmitted 
and certainly less processor time used. 


WINDOW *newwin(nlines, ncols, begin_y, begin_x) 
Create and return a pointer to a new window with the given num- 
ber of lines (or rows), nlines, and columns, ncols. The upper left 
corner of the window is at line begin_y, column begin_x. If either 
nlines or ncols is 0, they will be set to the value of lines—begin_y 
and cols—begin_x. A new full-screen window is created by calling 
newwin(0, 0, 0, 0). 


mvwin(win, y, x) 
Move the window so that the upper left corner will be at position (y, 
x). If the move would cause any portion of the window to be moved 
off the screen, it is an error and the window is not moved. 


WINDOW *subwin(orig, nlines, ncols, begin_y, begin_x) 
Create and return a pointer to a new window with the given 
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number of lines (or rows), nlines, and columns, ncols. The window 
is at position (begin_y, begin_x) on the screen. (This position is rel- 
ative to the screen, and not to the window orig.) The window is 
made in the middle of the window orig, so that changes made to 
one window will affect the character image of both windows. When 
changing the image of a subwindow, it will be necessary to call 
touchwin() or touchline() on orig before calling wrefresh() on 
orig. 


delwin(win) 


Delete the named window, freeing all memory associated with it. If 
you try to delete a main window before all of its subwindows have 
been deleted, ERR will be returned. 


WINDOW *newpad(nlines, ncols) 


Create and return a pointer to a new pad data structure with the 
given number of lines (or rows), nlines, and columns, ncols. A pad 
is a window that is not restricted by the screen size and is not nec- 
essarily associated with a particular part of the screen. Pads can 
be used when a large window is needed, and only a part of the win- 
dow will be on the screen at one time. Automatic refreshes of pads 
(e.g. from scrolling or echoing of input) do not occur. It is not legal 
to call wrefreeh() with a pad as an argument; the routines 
prefresh() or pnoutrefresh() should be called instead. 


Note that these routines require additional parameters to specify 
the part of the pad to be displayed and the location on the screen to 
be used for display. 


WINDOW *subpad(orig, nlines, ncols, begin_y, begin_x) 


Create and return a pointer to a subwindow within a pad with the 
given number of lines (or rows), nlines, and columns, ncols. Unlike 
subwin(), which uses screen coordinates, the window is at position 
(begin_y, begin_x) on the pad. The window is made in the middle of 
the window orig, so that changes made to one window will affect 
the character image of both windows. When changing the image of 
a subwindow, it will be necessary to call touchwin() or touch- 
line() on orig before calling prefresh() on orig. 


prefresh(pad, pminrow, pmincol, sminrow, smincol, smaxrow, smaxcol) 
pnoutrefresh(pad, pminrow, pmincol, sminrow, smincol, smaxrow, smaxcol) 
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These routines are analogous to wrefresh() and wnoutrefresh() 
except that pads, instead of windows, are involved. The additional 
parameters are needed to indicate what part of the pad and screen 
are involved. pminrow and pmincol specify the upper left corner, in 
the pad, of the rectangle to be displayed. sminrow, smincol, smax- 
row, and smaxcol specify the edges, on the screen, of the rectangle 
to be displayed in. The lower right corner in the pad of the rectan- 
gle to be displayed is calculated from the screen coordinates, since 
the rectangles must be the same size. Both rectangles must be 
entirely contained within their respective structures. Negative 
values of pminrow, pmincol, sminrow, or smincol are treated as if 
they were zero. 
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Section 3: Output 

These routines are used to manipulate text in windows. 

addch(ch) 

waddch(win, ch) 

mvaddch\y, x, ch) 

mvwaddch(win, y, x, ch) 
The character ch is put into the window at the current cursor posi- 
tion of the window and the position of the window cursor is 
advanced. Its function is similar to that of putchar (see putc(3S)). 
At the right margin, an automatic newline is performed. At the 
bottom of the scrolling region, if scrollok() is enabled, the scrolling 
region will be scrolled up one line. 


If ch is a tab, newline, or backspace, the cursor will be moved 
appropriately within the window. A newline also does a 
welrtoeol() before moving. Tabs are considered to be at every 
eighth column. If ch is another control character, it will be drawn 
in the *X notation. (Calling winch() on a position in the window 
containing a control character will not return the control charac- 
ter, but instead will return one character of the representation of 
the control character.) 


Video attributes can be combined with a character by OR-ing them 
into the parameter. This will result in these attributes also being 
set. (The intent here is that text, including attributes, can be 
copied from one place to another using winch() and waddch().) 
See wstandout(), below. 


Note that ch is actually of type chtype, not a character. 


Note that addch(), mvaddch(), and mvwaddch(), are macros. 

echochar(ch) 

wechochar(win, ch) 

pechochar(pad, ch) 
These routines are functionally equivalent to a call to addch(ch) 
followed by a call to refresh(), a call to waddch(win, ch) followed 
by a call to wrefresh(win), or a call to waddch(pad, ch) followed 
by acall to prefresh(pad). The knowledge that only a single char- 
acter is being output is taken into consideration and, for non-con- 
trol characters, a considerable performance gain can be seen by 
using these routines instead of their equivalents. In the case of 
pechochar‘ ), the last location of the pad on the screen is reused 
for the arguments to prefresh(). 


Note that ch is actually of type chtype, not a character. 


Note that echochar() is a macro. 
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addstr(str) 

waddstr(win, str) 

mvwaddstr(win, y, x, str) 

mvaddstr(y, x, str) 
These routines write all the characters of the null-terminated char- 
acter string str on the given window. This is equivalent to calling 
waddch() once for each character in the string. 


Note that addstr({), mvaddstr(), and mvwaddstr{ ) are macros. 

attroff(attrs) 

wattroff{(win, attrs) 

attron(attrs) 

wattron(win, attrs) 

attrset(attrs) 

wattrset(win, attrs) 

standend() 

wstandend(win) 

standout() 

wstandout(win) 
These routines manipulate the current attributes of the named 
window. These attributes can be any combination of the constants 
A_STANDOUT, A_REVERSE, A_BOLD, A_DIM, A_BLINK, 
A_UNDERLINE, and A_LALTCHARSET, as well as the macro 
COLOR_PAIR(n). These attributes are defined in <curses.h> and 
can be combined with the C logical OR (| ) operator. 


The current attributes of a window are applied to all characters 
that are written into the window with waddch(). Attributes are a 
property of the character, and move with the character through 
any scrolling and insert/delete line/character operations. To the 
extent possible on the particular terminal, they will be displayed as 
the graphic rendition of the characters put on the screen. 


wattrset(win, attrs) sets the current attributes of the given win- 
dow to atirs. wattroff(win, attrs) turns off the named attributes 
without turning on or off any other attributes. wattron(win, attrs) 
turns on the named attributes without affecting any others. 
wstandout(win, attrs) is the same as wattron(win, A_STAN- 
DOUT). wstandend(win, attrs) is the same as wattrset(win, 0), 
that is, it turns off all attributes. 


Note that wattroff{), wattron(), wattrset(), wstandend(), and 
wstandout() return Lat all times. 


Note that attrs is actually of type chtype, not a character. 


Note that attroff(), attron(), attrset(), standend(), and stan- 
dout() are macros. 


flash() These routines are used to signal the user. beep() will sound the 
audible alarm on the terminal, if possible, and if not, will flash the 
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screen (visible bell), if that is possible. flash() will flash the screen, 
and if that is not possible, will sound the audible signal. If neither 
signal is possible, nothing will happen. Nearly all terminals have 
an audible signal (bell or beep) but only some can flash the screen. 
box(win, vertch, horch) 
A box is drawn around the edge of the window, win. vertch and 
horch are the characters the box is to be drawn with. If vertch and 
horch are 0, then appropriate default characters, ACS_VLINE and 
ACS_HLINE, will be used. 


Note that vertch and horch are actually of type chtype, not charac- 


ters. 

erase() 

werase(win) 
These routines copy blanks to every position in the window. 
Note that erase() is a macro. 

clear() 

welear(win) 
These routines are like erase() and werase(), but they also call 
clearok(), arranging that the screen will be cleared completely on 
the next call to wrefresh() for that window, and repainted from 
scratch. 
Note that clear() is a macro. 

clrtobot() 

welrtobot(win) 
All lines below the cursor in this window are erased. Also, the cur- 
rent line to the right of the cursor, inclusive, is erased. 
Note that clrtobot() is a macro. 

clrtoeol() 

welrtoeol(win) 


The current line to the right of the cursor, inclusive, is erased. 


Note that clrtoeol() is a macro. 


delay_output(ms) 
Insert a ms millisecond pause in the output. It is not recommended 
that this routine be used extensively, because padding characters 
are used rather than a processor pause. 

delch() 

wdelch(win) 

mvdelch(y, x) 

mvwdelch(win, y, x) 
The character under the cursor in the window is deleted. All char- 
acters to the right on the same line are moved to the left one posi- 
tion and the last character on the line is filled with a blank. The 
cursor position does not change (after moving to (y, x), if specified). 
(This does not imply use of the hardware “delete-character” fea- 
ture.) 
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Note that delch(), mvdelch(), and mvwdelch() are macros. 


deleteln() 

wdeleteln(win) 
The line under the cursor in the window is deleted. All lines below 
the current line are moved up one line. The bottom line of the win- 
dow is cleared. The cursor position does not change. (This does not 
imply use of the hardware “delete-line” feature.) 


Note that deleteln() is a macro. 

getyx(win, y, x) 
The cursor position of the window is placed in the two integer vari- 
ables y and x. 


Note that getyx() is a macro, so no “&” is necessary before the 
variables y and x. 

getbegyx(win, y, x) 

getmaxyx(win, y, x) 
The current beginning coordinates (getbegyx( )) or size (get- 
maxyx()) of the specified window are placed in the two integer 
variables y and x. 


Note that getbegyx() and getmaxyx() are macros, so no “&” is 
necessary before the variables y and x. 

insch(ch) 

winsch(win, ch) 

mvwinsch(win, y, x, ch) 

mvinsch(y, x, ch) 
The character ch is inserted before the character under the cursor. 
All characters to the right are moved one space to the right, losing 
the rightmost character of the line. The cursor position does not 
change (after moving to (y, x), if specified). (This does not imply use 
of the hardware “insert-character” feature.) 


Note that ch is actually of type chtype, not a character. 


Note that insch(), mvinsch(), and mvwinsch() are macros. 
insertIn() 
winsertln(win) 
A blank line is inserted above the current line and the bottom line 
is lost. (This does not imply use of the hardware “insert-line” fea- 
ture.) 


Note that insertIn() is a macro. 

move(y, x) 

wmove(win, y, x) 
The cursor associated with the window is moved to line (row) y, col- 
umn x. This does not move the physical cursor of the terminal until 
wrefresh() is called. The position specified is relative to the upper 
left corner of the window, which is (0, 0). 
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Note that move() is a macro. 

overlay(srewin, dstwin) 

overwrite(srewin, dstwin) 
These routines overlay text from srewin on top of text from dstwin 
wherever the two windows overlap. The difference is that over- 
lay() is non-destructive (blanks are not copied), while overwrite() 
is destructive. 

copywin(srewin, dstwin, sminrow, smincol, dminrow, dmincol, dmaxrow, 

dmaxcol, overlay) 

This routine provides finer control over the overlay() and 
overwrite() routines. Asin the prefresh() routine, a rectangle is 
specified in the destination window, (dminrow, dmincol) and 
(dmaxrow, dmaxcol), and the upper-left-corner coordinates of the 
source window, (sminrow, smincol). If the argument overlay is 
true, then copying is non-destructive, as in overlay(). 

printw(fmt [, arg...]) 

wprintw(win, fmt [, arg...]) 

mvprintw(y, x, fmt [, arg...]) 

mvwprintw(win, y, x, fmt [, arg...]) 
These routines are analogous to printf{(3). The string which would 
be output by printf(3) is instead output using waddstr() on the 
given window. 


vwprintw(win, fmt, varglist) 
This routine corresponds to ufprintf(3S). It performs a wprintw() 
using a variable argument list. The third argument is a va_list, a 
pointer to a list of arguments, as defined in <varargs.h>. See the 
uprintf(3S) and varargs(5) manual pages for a detailed description 
on how to use variable argument lists. 


scroll(win) 
The window is scrolled up one line. This involves moving the lines 
in the window data structure. 

touchwin(win) 

touchline(win, start, count) 
Throw away all optimization information about which parts of the 
window have been touched, by pretending that the entire window 
has been drawn on. This is sometimes necessary when using over- 
lapping windows, since a change to one window will affect the other 
window, but the records of which lines have been changed in the 
other window will not reflect the change. touchline() only pre- 
tends that count lines have been changed, beginning with line 
start. 


Section 4: Input 

getch() 

wegetch(win) 

mvgetch(y, x) 

mvwegetch(win, y, x) 
Acharacter is read from the terminal associated with the window. 
In NODELAY mode, if there is no input waiting, the value ERR is 
returned. In DELAY mode, the program will hang until the system 
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passes text through to the program. Depending on the setting of 
ebreak(), this will be after one character (CBREAK mode), or after 
the first newline (NOCBREAK mode). In HALF-DELAY mode, the 
program will hang until a character is typed or the specified 
timeout has been reached. Unless noecho() has been set, the 
character will also be echoed into the designated window. 


When wgetch() is called, before getting a character, it will call 
wrefresh() if anything in the window has changed (for example, 
the cursor has moved or text changed). 


When using getch(), wgetch(), mvgetch(), or mvwgetch(), do 
not set both NOCBREAK mode (nocbreak( )) and ECHO mode 
(echo()) at the same time. Depending on the state of the tty(7) 
driver when each character is typed, the program may produce 
undesirable results. 


If wgetch() encounters a “D, it is returned (unlike stdio routines, 
which would return a null string and have a return code of -1). 


If keypad(win, TRUE) has been called, and a function key is 
pressed, the token for that function key will be returned instead of 
the raw characters. (See keypad() under "Input Options Setting.") 
Possible function keys are defined in <curses.h> with integers 
beginning with 0401, whose names begin with KEY_. Ifa character 
is received that could be the beginning of a function key (such as 
escape), curses will set a timer. If the remainder of the sequence is 
not received within the designated time, the character will be pas- 
sed through, otherwise the function key value will be returned. For 
this reason, on many terminals, there will be a delay after a user 
presses the escape key before the escape is returned to the pro- 
gram. (Use by a programmer of the escape key for a single charac- 
ter routine is discouraged. Also see notimeout( ) below.) 


Note that getch(), mvgetch(), and mvwgetch() are macros. 


wgetstr(win, str) 
mvgetstr(y, x, str) 
mvwgetstr(win, y, x, str) 


A series of calls to wgetch() is made, until a newline, carriage 
return, or enter key is received. The resulting value (except for 
this terminating character) is placed in the area pointed at by the 
character pointer str. The user’s erase and kill characters are 
interpreted. See wgetch() for how it handles characters differ- 
ently from stdio routines (especially “D). 


Note that getstr(), mvgetstr(), and mvwgetstr() are macros. 


ungetch(c) 


12/89 


Place c onto the input queue, to be returned by the next call to 
wgetch(). 
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flushinp() 
Throws away any typeahead that has been typed by the user and 
has not yet been read by the program. 


Note that flushinp() will not throw away any characters supplied 
by ungetch(). 

inch() 

winch(win) 

mvinch(y, x) 

mvwinch(win, y, x) 
The character, of type chtype, at the current position in the named 
window is returned. If any attributes are set for that position, 
their values will be OR’ed into the value returned. The predefined 
constants A_CHARTEXT and A_ATTRIBUTES, defined in 
<curses.h>, can be used with the C logical AND (&) operator to 
extract the character or attributes alone. 


Note that inch(), winch(), mvinch(), and mvwinch() are mac- 
ros. 

scanw(fmt [, arg...]) 

wscanw(win, fmt [, arg...]) 

mvscanw(y, x, fmt [, arg...]) 

mvwscanw(win, y, x, fmt [, arg...]) 
These routines correspond to scanf(3S), as do their arguments and 
return values. wgetstr() is called on the window, and the result- 
ing line is used as input for the scan. The return value for these 
routines is the number of arg values that are converted by fmt. arg 
values that are not converted are lost. See wgetstr() for how it 
handles strings differently than the stdio routines (especially “D). 


vwscanw(win, fmt, ap) 
This routine is similar to vwprintw() in that it performs a 
wscanw() using a variable argument list. The third argument is a 
va_list, a pointer to a list of arguments, as defined in <varargs.h>. 
See the vprintf(3S) and varargs(5) manual pages for a detailed 
description on how to use variable argument lists. 
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These routines set options within curses that deal with output. All options are 
initially FALSE, unless otherwise stated. It is not necessary to turn these 
options off before calling endwin(). 


clearok(win, bf) 
If enabled (bf is TRUE), the next call to wrefresh() with this win- 
dow will clear the screen completely and redraw the entire screen 
from scratch. This is useful when the contents of the screen are 
uncertain, or in some cases for a more pleasing visual effect. 


idlok(win, bf) 
If enabled (bf is TRUE), curses will consider using the hardware 
‘“Gnsert/delete-line” feature of terminals so equipped. If disabled (bf 
is FALSE), curses will very seldom use this feature. (The 
“insert/delete-character” feature is always considered.) This option 
should be enabled only if your application needs “insert/delete- 
line”, for example, for a screen editor. It is disabled by default 
because “insert/delete-line” tends to be visually annoying when 
used in applications where it isn’t really needed. If “insert/delete- 
line” cannot be used, curses will redraw the changed portions of all 
lines. Not calling idlok() saves approximately 5000 bytes of mem- 
ory. 

leaveok(win, bf) 
Normally, the hardware cursor is left at the location of the window 
cursor being refreshed. This option allows the cursor to be left 
wherever the update happens to leave it. It is useful for applica- 
tions where the cursor is not used, since it reduces the need for cur- 
sor motions. If possible, the cursor is made invisible when this 
option is enabled. 

setscrreg(top, bot) 

wsetscrreg(win, top, bot) 
These routines allow the user to set a software scrolling region in a 
window. top and bot are the line numbers of the top and bottom 
margin of the scrolling region. (Line 0 is the top line of the win- 
dow.) If this option and scrollok() are enabled, an attempt to 
move off the bottom margin line will cause all lines in the scrolling 
region to scroll up one line. (Note that this has nothing to do with 
use of a physical scrolling region capability in the terminal, like 
that in the DEC VT100. Only the text of the window is scrolled; if 
idlok() is enabled and the terminal has either a scrolling region or 
“insert/delete-line” capability, they will probably be used by the 
output routines.) 


Note that setscrreg() is a macro. 


scrollok(win, bf) 
This option controls what happens when the cursor of a window is 
moved off the edge of the window or scrolling region, either from a 
newline on the bottom line, or typing the last character of the last 
line. If disabled (6f is FALSE), the cursor is left on the bottom line 
at the location where the offending character was entered. If 
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enabled (bfis TRUE), wrefresh() is called on the window, and then 
the physical terminal and window are scrolled up one line. (Note 
that in order to get the physical scrolling effect on the terminal, it 
is also necessary to call idlok().) 


Note that scrollok() will always return OK. 


Section 6: Input Options Setting 

These routines set options within curses that deal with input. The options 

involve using ioct/(2) and therefore interact with curses routines. It is not nec- 

essary to turn these options off before calling endwin(). 

cbreak() 

nocbreak( ) 
These two routines put the terminal into and out of CBREAK mode, 
respectively. In CBREAK mode, characters typed by the user are 
immediately available to the program and erase/kill character pro- 
cessing is not performed. When in NOCBREAK mode, the tty driver 
will buffer characters typed until a newline or carriage return is 
typed. Interrupt and flow-control characters are unaffected by this 
mode (see termio(7)). Initially the terminal may or may not be in 
CBREAK mode, as it is inherited, therefore, a program should call 
cbreak() or nocbreak() explicitly. Most interactive programs 
using curses will set CBREAK mode. 


Note that cbreak() performs a subset of the functionality of raw(). 
See wgetch() under "Input" for a discussion of how these routines 
interact with echo() and noecho(). 


echo() 

noecho() These routines control whether characters typed by the user are 
echoed by wgetch() as they are typed. Echoing by the tty driver is 
always disabled, but initially wgetch() is in ECHO mode, so charac- 
ters typed are echoed. Authors of most interactive programs prefer 
to do their own echoing in a controlled area of the screen, or not to 
echo at all, so they disable echoing by calling noecho(). See 
wegetch() under "Input" for a discussion of how these routines 
interact with cbreak() and nocbreak(). 

ni() 

nonl() ‘These routines control whether carriage return is translated into 
newline on input by wgetch(). Initially, this translation is done; 
nonl() turns the translation off. Note that translation by the tty(7) 
driver is disabled in CBREAK mode. 


halfdelay(tenths) 
Half-delay mode is similar to CBREAK mode in that characters 
typed by the user are immediately available to the program. How- 
ever, after blocking for tenths tenths of seconds, ERR will be 
returned if nothing has been typed. tenths must be a number 
between 1 and 255. Use nocbreak() to leave half-delay mode. 


intrflush(win, bf) 
If this option is enabled, when an interrupt key is pressed on the 
keyboard (interrupt, break, quit) all output in the tty driver queue 
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will be flushed, giving the effect of faster response to the interrupt, 
but causing curses to have the wrong idea of what is on the screen. 
Disabling the option prevents the flush. The default for the option 
is inherited from the tty driver settings. The window argument is 
ignored. 

keypad(win, bf) 
This option enables curses to obtain information from the keypad of 
the user’s terminal. If enabled, the user can press a function key 
(such as an arrow key) and wgetch() will return a single value rep- 
resenting the function key, as in KEY_LEFT. If disabled, curses will 
not treat function keys specially and the program would have to 
interpret the escape sequences itself. If the keypad in the terminal 
can be turned on (made to transmit), calling keypad (win, TRUE) 
will turn it on. 

meta(win, bf) 
Initially, whether the terminal returns 7 or 8 significant bits on 
input depends on the control mode of the tty driver (see termio(7)). 
To force 8 bits to be returned, invoke meta (win, TRUE). To force 7 
bits to be returned, invoke meta (win, FALSE). The window argu- 
ment, win, is always ignored. If the terminfo(4) capabilities smm 
(meta_on) and rmm (meta_off) are defined for the terminal, smm 
will be sent to the terminal when meta (win, TRUE) is called and 
rmm will be sent when meta (win, FALSE) is called. 


nodelay(win, bf) 
This option causes wgetch() to be a non-blocking call. Ifno input 
is ready, wgetch() will return ERR. If disabled, wgetch() will 
hang until a key is pressed. 


notimeout(win, bf) 
While interpreting an input escape sequence, wgetch() will set a 
timer while waiting for the next character. If notimeout(win, 
TRUE) is called, then wgetch() will not set a timer. The purpose of 
the timeout is to differentiate between sequences received from a 
function key and those typed by a user. 

raw() 

noraw() The terminal is placed into or out of RAW mode. RAW mode is simi- 
lar to CBREAK mode, in that characters typed are immediately pas- 
sed through to the user program; however, in RAW mode, the inter- 
rupt, quit, suspend, and flow control characters are passed through 
uninterpreted, instead of generating a signal as they do in CBREAK 
mode. The behavior of the BREAK key depends on other bits in the 
tty(7) driver that are not set by curses. 


typeahead(fildes) 
curses does “line-breakout optimization” by looking for typeahead 
periodically while updating the screen. If input is found, and it is 
coming from a tty, the current update will be postponed until 
wrefresh() or doupdate() is called again. This allows faster 
response to commands typed in advance. Normally, the file 
descriptor for the input FILE pointer passed to newterm(), or 
stdin in the case that initser() was used, will be used to do this 
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typeahead checking. The typeahead() routine specifies that the 
file descriptor fildes is to be used to check for typeahead instead. If 
fildes is -1,then no typeahead checking will be done. 


Note that fildes is a file descriptor, not a <stdio.h> FILE pointer. 


Section 7: Environment Queries 
baudrate() 


Returns the output speed of the terminal. The number returned is 
in bits per second, for example, 9600, and is an integer. 


char erasechar() 


The user’s current erase character is returned. 


has_ic() True if the terminal has insert- and delete-character capabilities. 

has_il() True if the terminal has insert- and delete-line capabilities, or can 
simulate them using scrolling regions. This might be used to check 
to see if it would be appropriate to turn on physical scrolling using 
scrollok() or idlok(). 

char killchar() 
The user’s current line-kill character is returned. 

char *longname() 


This routine returns a pointer to a static area containing a verbose 
description of the current terminal. The maximum length of a ver- 
bose description is 128 characters. It is defined only after the call 
to initser() or newterm(). The area is overwritten by each call to 
newterm() and is not restored by set_term(), so the value should 
be saved between calls to newterm() if longname() is going to be 
used with multiple terminals. 


Section 8: Color Manipulation 
This section describes the color manipulation routines introduced in this 


release of curses. 
start_color() 


This routine requires no arguments. It must be called if the user 
wants to use colors, and before any other color manipulation rou- 
tine is called. It is good practice to call this routine right after 
initscr(). start_color() initializes eight basic colors (black, blue, 
green, cyan, red, magenta, yellow, and white), and two global vari- 
ables, COLORS and COLOR_PAIRS (respectively defining the maxi- 
mum number of colors and color-pairs the terminal can support). It 
also restores the terminal’s colors to the values they had when the 
terminal was just turned on. 


init_pair(pair, f, b) 


This routine changes the definition of a color-pair. It takes three 
arguments: the number of the color-pair to be changed, the fore- 
ground color number, and the background color number. The value 
of the first argument must be between 1 and COLOR_PAIRS-1. The 
value of the second and third arguments must be between 0 and 
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COLORS-1. If the color-pair was previously initialized, the screen 
will be refreshed and all occurrences of that color-pair will be 
changed to the new definition. 


init_color(color, r, g, b) 
This routine changes the definition of a color. It takes four argu- 
ments: the number of the color to be changed followed by three 
RGB values (for the amounts of red, green, and blue components). 
The value of the first argument must be between 0 and COLORS-1. 
(See the section COLOR for the default color index.) The last three 
arguments must each be a value between 0 and 1000. When 
init_color() is used, all occurrences of that color on the screen 
immediately change to the new definition. 


has_colors() 
This routine requires no arguments. It returns TRUE if the termi- 
nal can manipulate colors, FALSE otherwise. This routine facili- 
tates writing terminal-independent programs. For example, a pro- 
grammer can use it to decide whether to use color or some other 
video attribute. 


can_change_color() 
This routine requires no arguments. It returns TRUE if the termi- 
nal supports colors and can change their definitions, FALSE other- 
wise. This routine facilitates writing terminal-independent pro- 
grams. 


color_content(color, &r, &g, &b) 
This routine gives users a way to find the intensity of the red, 
green, and blue (RGB) components in a color. It requires four argu- 
ments: the color number, and three addresses of shorts for storing 
the information about the amounts of red, green, and blue compo- 
nents in the given color. The value of the first argument must be 
between 0 and COLORS-1. The values that will be stored at the 
addresses pointed to by the last three arguments will be between 0 
(no component) and 1000 (maximum amount of component). 


pair_content(pair, &f, &b) 
This routine allows users to find out what colors a given color-pair 
consists of. It requires three arguments: the color-pair number, 
and two addresses of shorts for storing the foreground and the 
background color numbers. The value of the first argument must 
be between 1 and COLOR_PAIRS-1. The values that will be stored 
at the addresses pointed to by the second and third arguments will 
be between 0 and COLORS-1. 


Section 9: Soft Labels 
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If desired, curses will manipulate the set of soft function-key labels that exist 
on many terminals. For those terminals that do not have soft labels, curses 
can simulate them by taking over the bottom line of stdser, reducing the size 
of stdser and the variable LINES. curses standardizes on 8 labels of 8 charac- 
ters each. If a curses program changes the values of the soft labels, it can 
restore them only to the default settings for that terminal. (Note also that 
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soft labels are shown in reverse video by default.) Therefore, if before calling a 
curses program a user changes the values of the soft labels, those values can- 
not be reset when the curses program terminates. 


slk_init(labfmt) 
In order to use soft labels, this routine must be called before 
initser() or newterm() is called. If initscr() winds up using a line 
from stdscr to emulate the soft labels, then labfmt determines how 
the labels are arranged on the screen. Setting labfmt to 0 indicates 
that the labels are to be arranged in a 3-2-3 arrangement; lasks 
for a 44 arrangement. 


slk_set(labnum, label, labfmt) 
labnum is the label number, from 1 to 8. label is the string to be 
put on the label, up to 8 characters in length. A NULL string or a 
NULL pointer will put up a blank label. labfmt is one of 0, lor 2, to 
indicate whether the label is to be left-justified, centered, or right- 
justified within the label. 

slk_refresh() 

slk_noutrefresh() 
These routines correspond to the routines wrefresh() and 
wnoutrefresh(). Most applications would use slk_noutrefresh() 
because a wrefresh() will most likely soon follow. 


char *slk_labeldabnum) 
The current label for label number Jabnum is returned, in the same 
format as it was in when it was passed to slk_set(); that is, how it 
looked prior to being justified according to the labfmt argument of 
slk_set(). 


slk_clear() 
The soft labels are cleared from the screen. 


slk_restore() 
The soft labels are restored to the screen after a slk_clear‘(). 


slk_touch() 
All of the soft labels are forced to be output the next time a 
slk_noutrefresh() is performed. 

slk_attron(attrs) 

slk_attrset(attrs) 

slk_attroff(attrs) 
These routines correspond to attron(), attrset(), and attroff(). 
They will have effect only if soft labels are simulated on the bottom 
line of the screen. 


Section 10: Low-Level curses Access 

The following routines give low-level access to various curses functionality. 

These routines typically would be used inside library routines. 

def_prog_mode() 

def_shell_mode({) 
Save the current terminal modes as the “program” (in curses) or 
“shell” (not in curses) state for use by the reset_prog_mode() and 
reset_shell_mode() routines. This is done automatically by 
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initscr(). 

reset_prog_mode() 

reset_shell_mode() 
Restore the terminal to “program” (in curses) or “shell” (out of 
curses) state. These are done automatically by endwin() and 
doupdate() after an endwin(), so they normally would not be 
called. 

resetty() 

savetty() These routines save and restore the state of the terminal modes. 
savetty() saves the current state of the terminal in a buffer and 
resetty() restores the state to what it was at the last call to 
savetty(). 


getsyx(y, x) 
The current coordinates of the virtual screen cursor are returned in 
yandx. If leaveok() is currently TRUE, then -L-1 will be 
returned. If lines have been removed from the top of the screen 
using ripoffline(), y and x include these lines; therefore, y and x 
should be used only as arguments for setsyx(). 


Note that getsyx() is a macro, so no “&” is necessary before the 
variables y and x. 


setsyx(y, x) 
The virtual screen cursor is set to y, x. Ify and x are both -1, then 
leaveok() will be set. The two routines getsyx() and setsyx() are 
designed to be used by a library routine which manipulates curses 
windows but does not want to change the current position of the 
program’s cursor. The library routine would call getsyx() at the 
beginning, do its manipulation of its own windows, do a 
wnoutrefresh() on its windows, call setsyx(), and then call doup- 
date(). 

ripoffline(line, init) 
This routine provides access to the same facility that slk_init() 
uses to reduce the size of the screen. ripoffline() must be called 
before initscr() or newterm() is called. If line is positive, a line 
will be removed from the top of stdscr; if negative, a line will be 
removed from the bottom. When this is done inside initser{), the 
routine init() is called with two arguments: a window pointer to 
the 1-line window that has been allocated and an integer with the 
number of columns in the window. Inside this initialization rou- 
tine, the integer variables LINES and COLS (defined in 
<curses.h>) are not guaranteed to be accurate and wrefresh() or 
doupdate() must not be called. It is allowable to call 
wnoutrefresh() during the initialization routine. 


ripoffline() can be called up to five times before calling initser() 
or newterm(). 


scr_dump(filename) 
The current contents of the virtual screen are written to the file 
filename. 
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scr_restore(filename) 
The virtual screen is set to the contents of filename, which must 
have been written using scr_dump(). ERR is returned if the con- 
tents of filename are not compatible with the current release of 
curses software. The next call to doupdate() will restore the 
screen to what it looked like in the dump file. 


scr_init(filename) 
The contents of filename are read in and used to initialize the 
curses data structures about what the terminal currently has on its 
screen. If the data is determined to be valid, curses will base its 
next update of the screen on this information rather than clearing 
the screen and starting from scratch. scr_init() would be used 
after initscr() or a system (8S) call to share the screen with 
another process which has done a scr_dump() after its endwin() 
call. The data will be declared invalid if the terminfo(4) capability 
nrrmc is true or the time-stamp of the tty is old. Note that 
keypad(), meta(), slk_clear(), curs_set(), flash(), and beep() do 
not affect the contents of the screen, but will make the tty’s time- 
stamp old. 

curs_set(visibility) 
The cursor state is set to invisible, normal, or very visible for visi- 
bility equal to 0, lor 2. If the terminal supports the visibility 
requested, the previous cursor state is returned; otherwise, ERR is 
returned. 


draino(ms) 
Wait until the output has drained enough that it will only take ms 
more milliseconds to drain completely. 


garbagedlines(win, begline, numlines) 
This routine indicates to curses that a screen line is garbaged and 
should be thrown away before having anything written over the top 
of it. It could be used for programs such as editors which want a 
command to redraw just a single line. Such a command could be 
used in cases where there is a noisy communications line and 
redrawing the entire screen would be subject to even more commu- 
nication noise. Just redrawing the single line gives some semb- 
lance of hope that it would show up unblemished. The current loca- 
tion of the window is used to determine which lines are to be 
redrawn. 


napms(ms) 
Sleep for ms milliseconds. 


mveur(oldrow, oldcol, newrow, newcol) 
Low-level cursor motion. 


Section 11: Terminfo-Level Manipulations 
These low-level routines must be called by programs that need to deal directly 
with the terminfo(4) database to handle certain terminal capabilities, such as 
programming function keys. For all other functionality, curses routines are 
more suitable and their use is recommended. 
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Initially, setupterm() should be called. (Note that setupterm() is automati- 
cally called by initscr() and newterm().) This will define the set of terminal- 
dependent variables defined in the terminfo(4) database. The terminfo(4) vari- 
ables lines and columns (see terminfo(4)) are initialized by setupterm() as 
follows: if the environment variables LINES and COLUMNS exist, their val- 
ues are used. If the above environment variables do not exist and the program 
is running in a layer (see layers(1)), the size of the current layer is used. 
Otherwise, the values for lines and columns specified in the terminfo(4) 
database are used. 


The header files <curses.h> and <term.h> should be included, in this order, 
to get the definitions for these strings, numbers, and flags. Parameterized 
strings should be passed through tparm() to instantiate them. All terminfo(4) 
strings (including the output of tparm()) should be printed with tputs() or 
putp(). Before exiting, reset_shell_mode( ) should be called to restore the 
tty modes. Programs which use cursor addressing should output 
enter_ca_mode upon startup and should output exit_ca_mode before exit- 
ing (see terminfo(4)). (Programs desiring shell escapes should call 
reset_shell_mode() and output exit_ca_mode before the shell is called and 
should output enter_ca_mode and call reset_prog_mode() after returning 
from the shell. Note that this is different from the curses routines (see 
endwin()). 


setupterm(term, fildes, errret) 
Reads in the terminfo(4) database, initializing the terminfo(4) 
structures, but does not set up the output virtualization structures 
used by curses. The terminal type is in the character string term: 
if term is NULL, the environment variable TERM will be used. All 
output is to the file descriptor fildes. If errret is not NULL, then 
setupterm() will return OK or ERR and store a status value in the 
integer pointed to by errret. A status of lin errret is normal, 0 
means that the terminal could not be found, and —-1 means that the 
terminfo(4) database could not be found. If ervret is NULL, setup- 
term() will print an error message upon finding an error and exit. 
Thus, the simplest call is setupterm ((char *)0, 1, (int *)0), 
which uses all the defaults. 


The terminfo(4) boolean, numeric and string variables are stored in 
a structure of type TERMINAL. After setupterm() returns suc- 
cessfully, the variable cur_term (of type TERMINAL *) is initial- 
ized with all of the information that the terminfo(4) boolean, 
numeric and string variables refer to. The pointer may be saved 
before calling setupterm() again. Further calls to setupterm() 
will allocate new space rather than reuse the space pointed to by 
cur_term. 


set_curterm(nterm) 
nterm is of type TERMINAL *. set_curterm() sets the variable 
cur_term to nterm, and makes all of the terminfo(4) boolean, 
numeric and string variables use the values from nterm. 
del_curterm(oterm) 
oterm is of type TERMINAL *. del_curterm() frees the space 
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pointed to by oterm and makes it available for further use. If oterm 
is the same as cur_term, then references to any of the terminfo(4) 
boolean, numeric and string variables thereafter may refer to inva- 
lid memory locations until another setupterm() has been called. 


restartterm(term, fildes, errret) 
Similar to setupterm(), except that it is called after restoring 
memory to a previous state; for example, after a call to 
scr_restore(). It assumes that the windows and the input and out- 
put options are the same as when memory was saved, but the ter- 
minal type and baud rate may be different. 


char *tparm(str, p1, p2, ..., p9) 
Instantiate the string str with parms pi. A pointer is returned to 
the result of str with the parameters applied. 


tputs(str, count, pute) 
Apply padding to the string str and output it. str must be a ter- 
minfo(4) string variable or the return value from tparm(), 
tgetstr( ), tigetstr() or tgoto(). count is the number of lines 
affected, or Lif not applicable. putc is a putchar(3S)-like routine to 
which the characters are passed, one at a time. 


putp(str) A routine that calls tputs (str, 1, putchar). 


vidputs(attrs, putc) 
Output a string that puts the terminal in the video attribute mode 
attrs, which is any combination of the attributes listed below. The 
characters are passed to the putchar(3S)-like routine putc(). 


vidattr(attrs) 
Similar to vidputs(), except that it outputs through putchar(38). 


The following routines return the value of the capability corresponding to the 
character string containing the terminfo(4) capname passed to them. For 
example, re = tigetstr("acsc") causes the value of acsc to be returned in re. 


tigetflag(capname) 
The value —1is returned if capname is not a boolean capability. 
The value 0 is returned if capname is not defined for this terminal. 


tigetnum(capname) 
The value -2 is returned if capname is not a numeric capability. 
The value -1is returned if capname is not defined for this terminal. 


tigetstr(capname) 
The value (char *) —Lis returned if capname is not a string capabil- 
ity. A null value is returned if capname is not defined for this ter- 
minal. 

char *boolnameg| J, *boolcodes{ J, *+boolfnames| } 

char +numnameg| J, *numcodes| ], *numfnames{ ] 

char *strnames| ], *strcodes| J, *strfnames[ ] 
These null-terminated arrays contain the capnames, the termcap 
codes, and the full C names, for each of the terminfo(4) variables. 
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Section 12: Termcap Emulation 


These routines are included as a conversion aid for programs that use the 
termcap library. Their parameters are the same and the routines are emu- 
lated using the terminfo(4) database. 


tgetent(bp, name) 
Look up termcap entry for name. The emulation ignores the buffer 
pointer bp. 

tgetflag(codename) 
Get the boolean entry for codename. 


tgetnum(codename) 
Get numeric entry for codename. 


char +tgetstr(codename, area) 
Return the string entry for codename. If area is not NULL, then 
also store it in the buffer pointed to by area and advance area. 
tputs() should be used to output the returned string. 


char *tgoto(cap, col, row) 
Instantiate the parameters into the given capability. The output 
from this routine is to be passed to tputs(). 


tputa(str, affent, putc) 


See tputs() above, under "TERMINFO-LEVEL MANIPULA- 
TIONS". 


Section 13: Miscellaneous 


traceoff{ ) 

traceon() 
Turn off and on debugging trace output when using the debug ver- 
sion of the curses library. This facility is available only to custom- 
ers with a source license. 


unctrl(c) This macro expands to a character string which is a printable rep- 
resentation of the character c. Control characters are displayed in 
the *X notation. Printing characters are displayed as is. 


unctrl() is a macro, defined in <unctrl.h>, which is automatically 
included by <curses.h>. 


char *keyname(c) 
Acharacter string corresponding to the key c is returned. 


filter() | This routine is one of the few that is to be called before initser() or 
newterm() is called. It arranges things so that curses thinks that 
there is a 1-line screen. curses will not use any terminal capabili- 
ties that assume that they know what line on the screen the cursor 
is on. 


Section 14: Use of curscr 


The special window curser can be used in only a few routines. If the window 
argument to clearok() is curser, the next call to wrefresh() with any win- 
dow will cause the screen to be cleared and repainted from scratch. Ifthe 
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window argument to wrefresh() is curscr, the screen is immediately cleared 
and repainted from scratch. (This is how most programs would implement a 
“repaint-screen” routine.) The source window argument to overlay(), 
overwrite(), and copywin() may be curscr, in which case the current con- 
tents of the virtual terminal screen will be accessed. 


Section 15: Obsolete Calls 
Various routines are provided to maintain compatibility in programs written 
for older versions of the curses library. These routines are all emulated as 


indicated below. 

ermode() Replaced by cbreak(). 

fixterm() Replaced by reset_prog_mode(). 

gettmode() A no-op. 

nocrmode( ) Replaced by nocbreak(). 

resetterm() Replaced by reset_shell_mode(). 

saveterm() Replaced by def_prog_mode(). 

setterm() Replaced by setupterm(). 
ATTRIBUTES 


The following video attributes, defined in <curses.h>, can be passed to the 
routines wattron(), wattroff(), and wattrset(), or OR’ed with the characters 
passed to waddch(). 


A_STANDOUT Terminal’s best highlighting mode 
A_UNDERLINE Underlining 


A_REVERSE Reverse video 

A_BLINK Blinking 

A_DIM Half bright 

A_BOLD Extra bright or bold 

A_ALTCHARSET Alternate character set 

A_NORMAL Turn all attributes off, for example: 
wattrset (win, A NORMAL) 


COLOR_PAIR(n) _Color-pair defined in n (note that this is a macro) 
The following bit-masks may be AND’ed with characters returned by winch(). 


A_CHARTEXT Extract character 
A_ATTRIBUTES Extract attributes 
A_COLOR Extract color-pair field information 


The following macro is the reverse of COLOR_PAIR(n). 


PAIR_NUMBER(attrs) - Returns the pair number associated with the 
COLOR_PAIR(n) attribute (note that this is a macro) 


COLORS 
In <curses.h> the following macros are defined to have the numeric value 
shown. These are the default colors. curses also assumes that color 0 (zero) is 
the default background color for all terminals. 


COLOR_BLACK 0 
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COLOR_BLUE 
COLOR_GREEN 
COLOR_CYAN 
COLOR_RED 
COLOR_MAGENTA 
COLOR_YELLOW 
COLOR_WHITE 


FUNCTION KEYS 


NOR ONE 
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The following function keys, defined in <curses.h>, might be returned by 
wgetch() if keypad() has been enabled. Note that not all of these may be 
supported on a particular terminal if the terminal does not transmit a unique 
code when the key is pressed or the definition for the key is not present in the 


terminfo(4) database. 

Name Value 
KEY_BREAK 0401 
KEY_DOWN 0402 
KEY_UP 0403 
KEY_LEFT 0404 
KEY_RIGHT 0405 
KEY_HOME 0406 
KEY_BACKSPACE 0407 
KEY_FO 0410 
KEY_F(n) (KEY_F0+(n)) 
KEY_DL 0510 
KEY_IL 0511 
KEY_DC 0512 
KEY_IC 0513 
KEY_EIC 0514 
KEY_CLEAR 0515 
KEY_EOS 0516 
KEY_EOL 0517 
KEY_SF 0520 
KEY_SR 0521 
KEY_NPAGE 0522 
KEY_PPAGE 0523 
KEY_STAB 0524 
KEY_CTAB 0525 
KEY_CATAB 0526 
KEY_ENTER 0527 
KEY_SRESET 0530 
KEY_RESET 0531 
KEY_PRINT 0532 


Key name 


break key (unreliable) 
The four arrow keys... 


Home key (upward+left arrow) 
backspace (unreliable) 

Function keys - space for 64 keys reserved. 
Formula for f_. 

Delete line 

Insert line 

Delete character 

Insert char or enter insert mode 
Exit insert char mode 

Clear screen 

Clear to end of screen 

Clear to end of line 

Scroll 1 line forward 

Scroll 1 line backwards (reverse) 
Next page 

Previous page 

Set tab 

Clear tab 

Clear all tabs 

Enter or send 

soft (partial) reset 

reset or hard reset 

print or copy 
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KEY_PREVIOUS 
KEY_REDO 
KEY_REFERENCE 
KEY_REFRESH 
KEY_REPLACE 
KEY_RESTART 
KEY_RESUME 
KEY_SAVE 
KEY_SBEG 
KEY_SCANCEL 
KEY_SCOMMAND 
KEY_SCOPY 
KEY_SCREATE 
KEY_SDC 
KEY_SDL 
KEY_SELECT 
KEY_SEND 
KEY_SEOL 
KEY_SEXIT 
KEY_SFIND 
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0534 
0535 
0536 
0537 
0540 
0541 
0542 
0543 
0544 
0545 
0546 
0547 
0550 
0551 
0552 
0553 
0554 
0555 
0556 
0557 
0560 
0561 
0562 
0563 
0564 
0565 
0566 
0567 
0570 
0571 
0572 
0573 
0574 
0575 
0576 
0577 
0600 
0601 
0602 
0603 
0604 
0605 
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home down or bottom (lower left) 
keypad is arranged like this: 
Al up A3 
left B2 right 
C1 down C3 
Upper left of keypad 
Upper right of keypad 
Center of keypad 
Lower left of keypad 
Lower right of keypad 
Back tab key 
beg(inning) key 
cancel key 
close key 
cmd (command) key 
copy key 
create key 
end key 
exit key 
find key 
help key 
mark key 
message key 
move key 
next object key 
open key 
options key 
previous object key 
redo key 
reference) key 
refresh key 
replace key 
restart key 
resume key 
save key 
shifted beginning key 
shifted cancel key 
shifted command key 
shifted copy key 
shifted create key 
shifted delete char key 
shifted delete line key 
select key 
shifted end key 
shifted clear line key 
shifted exit key 
shifted find key 
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KEY_SHELP 0606 
KEY_SHOME 0607 
KEY_SIC 0610 
KEY_SLEFT 0611 
KEY_SMESSAGE 0612 
KEY_SMOVE 0613 
KEY_SNEXT 0614 
KEY_SOPTIONS 0615 
KEY_SPREVIOUS 0616 
KEY_SPRINT 0617 
KEY_SREDO 0620 
KEY_SREPLACE 0621 
KEY_SRIGHT 0622 
KEY_SRSUME 0623 
KEY_SSAVE 0624 
KEY_SSUSPEND 0625 
KEY_SUNDO 0626 
KEY_SUSPEND 0627 
KEY_UNDO 0630 


LINE GRAPHICS 
The following variables may be used to add line-drawing characters to the 
screen with waddch(). When defined for the terminal, the variable will have 
the A ALTCHARSET bit turned on. Otherwise, the default character listed 
below will be stored in the variable. The names were chosen to be consistent 
with the DEC VT100 nomenclature. 


12/89 


Name Default 
ACS_ULCORNER 
ACS_LLCORNER 
ACS_URCORNER 
ACS_LRCORNER 
ACS_RTEE 
ACS_LTEE 
ACS_BTEE 
ACS_TTEE 
ACS_HLINE 
ACS_VLINE 
ACS_PLUS 
ACS_S1 

ACS_S9 
ACS_DIAMOND 
ACS_CKBOARD 
ACS_DEGREE 
ACS_PLMINUS 
ACS_BULLET 
ACS_LARROW 


ltoltte ee eeet 


+1 
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shifted help key 
shifted home key 
shifted input key 
shifted left arrow key 
shifted message key 
shifted move key 
shifted next key 
shifted options key 
shifted prev key 
shifted print key 
shifted redo key 
shifted replace key 
shifted right arrow 
shifted resume key 
shifted save key 
shifted suspend key 
shifted undo key 
suspend key 

undo key 


Glyph Description 


upper left corner 
lower left corner 
upper right corner 
lower right corner 
right tee 

left tee 

bottom tee 

top tee 

horizontal line 
vertical line 

plus 

scan line 1 

scan line 9 
diamond 

checker board (stipple) 
degree symbol 
plus/minus 

bullet 

arrow pointing left 
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ACS_RARROW > arrow pointing right 

ACS_DARROW v arrow pointing down 

ACS_UARROW wi arrow pointing up 

ACS_BOARD # board of squares 

ACS_LANTERN # lantern symbol 

ACS_BLOCK # solid square block 
DIAGNOSTICS 


BUGS 


All routines return the integer OK upon successful completion and the integer 
ERR upon failure, unless otherwise noted in the preceding routine descrip- 
tions. 

All macros return the value of their w version, except getsyx(), getyx(), get- 
begyx(), getmaxyx(). For these macros, no useful value is returned. 


Routines that return pointers always return (type *) NULL on error. 


Currently typeahead checking is done using a nodelay read followed by an 
ungetch() of any character that may have been read. Typeahead checking is 
done only if wgetch() has been called at least once. This may change when 
proper kernel support is available. Programs which use a mixture of their 
own input routines with curses input routines may wish to call typeahead(-1) 
to turn off typeahead checking. 


The argument to napma() is currently rounded up to the nearest second. 
draino (ms) only works for ms equal to 0. 


WARNINGS 


If the new curses features are used, code cannot be compiled and linked on sys- 
tems having UNIX System V Release 3.1 or earliler. Code written for previous 
releases of curses is compatible with this version. 


The plotting library plot(3X) and the curses library curses (3X) both use the 
names erase() and move(). The curses versions are macros. If you need both 
libraries, put the plot(3X) code in a different source file than the curses (3X) 
code, and/or #undef move() and erase() in the plot(3X) code. 


Between the time a call to initser() and endwin() has been issued, use only 
the routines in the curses library to generate output. Using system calls or 
the "standard I/O package" (see stdio(3S)) for output during that time can 
cause unpredictable results. 


If a pointer passed to a routine as a window argument is null or out of range, 
the results are undefined (core may be dumped). 


SEE ALSO 
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vprintf(3S) profile(4), ferm(4), terminfo(4), varargs(5), termio(7), tty(7) 
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directory: opendir, readdir, telldir, seekdir, rewinddir, closedir — directory 
operations 


SYNOPSIS 


#include <sys/types.h> 
#include <dirent.h> 
DIR *opendir (filename) 
char *filename; 

struct dirent +readdir (dirp) 
DIR +dirp; 

long telldir (dirp) 

DIR +dirp; 

void seekdir (dirp, loc) 
DIR +dirp; 

long loc; 

void rewinddir (dirp) 
DIR *dirp; 

void closedir(dirp) 

DIR *dirp; 


DESCRIPTION 
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opendir opens the directory named by filename and associates a directory 
stream with it. opendir returns a pointer to be used to identify the directory 
stream in subsequent operations. The file descriptor associated with this 
directory stream is marked to be closed if the calling process makes a system 
call belonging to the exec(2) family. The pointer NULL is returned if 
filename cannot be accessed or is not a directory, or if it cannot malloc(3X) 
enough memory to hold a DIR structure or a buffer for the directory entries. 


readdir returns a pointer to the next active directory entry. No inactive 
entries are returned. It returns NULL upon reaching the end of the directory 
or upon detecting an invalid location in the directory. 

telldir returns the current location associated with the named directory 
stream. 

seekdir sets the position of the next readdir operation on the directory 
stream. The new position reverts to the one associated with the directory 
stream when the telldir operation from which loc was obtained was per- 
formed. 

rewinddir resets the position of the named directory stream to the beginning 
of the directory. 


closedir closes the named directory stream and frees the DIR structure. 


The following errors can occur as a result of these operations. 
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opendir: 

(ENOTDIR] Acomponent of filename is not a directory. 

[EACCES] Acomponent of filename denies search permission. 

(EMFILE] The maximum number of file descriptors are currently open. 

(EFAULT] filename points outside the allocated address space. 

readdir: 

{ENOENT] The current file pointer for the directory is not located at a 
valid entry. 

[EBADF] The file descriptor determined by the DIR stream is no longer 


valid. This results if the DIR stream has been closed. 


telldir, seekdir, and closedir: 


(EBADF] The file descriptor determined by the DIR stream is no longer 
valid. This results if the DIR stream has been closed. 


EXAMPLES 
Sample code which searches a directory for entry name: 


dirp = opendir( "." ); 
while ( (dp = readdir( dirp )) != NULL ) 
if ( strcemp( dp->d_name, name ) == 0 ) 
{ 
closedir( dirp ); 
return FOUND; 
} 
closedir( dirp ); 
return NOT_FOUND; 


NOTES 
When scanning a directory, entries may be missed if they are created after the 
directory scan has begun. This happens if a created entry is inserted before 
the current location of the directory pointer. The same thing happens if 
telldir is used to save the directory position. If a directory entry is entered 
before this location, it is missed when the directory scan continues. 


SEE ALSO 
getdents(2), dirent(4) 


WARNINGS 
rewinddir is implemented as a macro, so its function address cannot be 
taken. 
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@ NAME 


getspent, getspnam, setspent, endspent, fgetspent, Ickpwdf, ulckpwdf— get 
shadow password file entry 


SYNOPSIS 


#include <shadow.h> 
struct spwd *getspent ( ) 


struct spwd *getspnam (name) 
char *name; 


int Ickpwdf ( ) 
int ulckpwdf ( ) 
void setspent ( ) 
void endspent ( ) 


struct spwd *fgetspent (fp) 
FILE +fp; 


DESCRIPTION 
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The getspent and getspnam routines each return a pointer to an object with 
the following structure containing the broken-out fields of a line in the 
/etc/shadow file. Each line in the file contains a shadow password structure, 
declared in the < shadow.h> header file: 


struct spwd{ 
char *sp_namp; 
char *sp_pwdp; 
long sp_lstchg; 
long sp_min; 
long sp_max; 
Me 
When first called, getspent returns a pointer to the first spwd structure in 
the file; thereafter, it returns a pointer to the next spwd structure in the file 
so successive calls can be used to search the entire file. The getspnam rou- 
tine searches from the beginning of the file until a login name matching name 
is found, and returns a pointer to the particular structure in which it was : 
found. The getspent and getspnam routines populate the sp_min, sp_max, 
or sp_Istchg field with —1 if the corresponding field in /etc/shadow is empty. 
If an end-of-file or an error is encountered on reading, or there is a format 
error in the file, these functions return a NULL pointer. 


/etc/.pwd.lock is the lock file. It is used to coordinate modification access to 
the password files /etc/passwd and /etc/shadow. lckpwdf(3x) and 
ulckpwdf(3x) are routines that are used to gain modification access to the 
password files through the lock file. A process first uses lckpwdf to lock the 
lock file thereby gaining exclusive rights to modify the /etc/passwd or 
/etc/shadow password file. Upon completing modifications, a process should 
release the lock on the lock file via ulckpwdf. This prevents simultaneous 
modification of the password files. 

The Ickpwdf routine attempts to lock the file /etc/.pwd.lock. If file 


/etc/.pwd.lock is already locked, Ickpwdf tries for 15 seconds to lock the file. 
If lckpwdf is unsuccessful, it returns a —1. If lckpwdf succeeds in locking 


GETSPENT(3X) DYNIX/ptx 


FILES 


/etc/.pwd.lock within 15 seconds, then a return code other than —1 is 
returned. 


The ulckpwdf routine attempts to unlock the file /etc/.pwd.lock. If success- 
ful, ulckpwdf returns a 0. If the unlocking failed, for example in the case 
where /etc/.pwd.lock was not locked initially, ulekpwdf returns a -1. 


Acall to setspent has the effect of rewinding the shadow password file to 
allow repeated searches. The endspent routine may be called to close the 
shadow password file when processing is complete. 


The fgetspent routine returns a pointer to the next spwd structure in the 
stream fp, which matches the format of /ete/shadow. 


/etc/shadow, /etc/passwd, /etc/.pwd.lock 


SEE ALSO 


mkpwdbm(1M), passmgmt(1M), putspent(3X) 


DIAGNOSTICS 


ANULL pointer is returned on EOF or error. 


WARNINGS 


If a program not otherwise using standard Y/O uses this routine, the size of the 
program increase more than might be expected. 


All information is contained in a static area, so it must be copied if it is to be 
saved. 
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NAME 


ldahread — read the archive header of a member of an archive file 


SYNOPSIS 


#include <stdio.h> 
#include <ar.h> 
#include <filehdr.h> 
#include <ldfcn.h> 


int Idahread (ldptr, arhead) 
LDFILE *ldptr; 
ARCHDR ‘tarhead; 


DESCRIPTION 


If TYPE(Idptr) is the archive file magic number, Idahread reads the archive 
header of the common object file currently associated with Idptr into the area 
of memory beginning at arhead. 


ldahread returns SUCCESS or FAILURE. Idahread fails if TYPE(Idptr) 
does not represent an archive file, or if it cannot read the archive header. 


The program must be loaded with the object file access routine library libld.a. 


SEE ALSO 
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ldclose (3X), Idopen(3X), intro(4), ldfen(4), path.h(4), ldclose(3X), Idopen(3X), 
ldfen(4), ar(4) 
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NAME 
ldclose, Idaclose — close a common object file 


SYNOPSIS 
#include <stdio.h> 
#include <filehdr.h> 
#include <Idfcn.h> 


int Idclose (Idptr) 
LDFILE *ldptr; 
int Idaclose (ldptr) 
LDFILE *lIdptr; 

DESCRIPTION 
Idopen(3X) and Idclose are designed to provide uniform access to both simple 
object files and object files that are members of archive files. Thus an archive 
of common object files can be processed as if it were a series of simple common 
object files. 


If TYPE(Idptr) does not represent an archive file, Idclose closes the file and 
frees the memory allocated to the LDFILE structure associated with Idptr. 


If TYPE(Idptr) is the magic number of an archive file, and if there are any 
more files in the archive, ldclege reinitializes OFFSET(Idptr) to the file 
address of the next archive member and returns FAILURE. The LDFILE 
structure is prepared for a subsequent Idopen(3X). In all other cases, Idclose 
returns SUCCESS. 

Idaclose closes the file and frees the memory allocated to the LDFILE struc- 
ture associated with Idptr regardless of the value of TYPE(Idptr). Idaclose 
always returns SUCCESS. The function is often used in conjunction with 
Idaopen. 


The program must be loaded with the object file access routine library libld.a. 


SEE ALSO 
felose(3S), ldopen(3X), intro(4), ldfen(4), paths.h(4), felose(3S), Idopen(3X), 
ldfen(4) 
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NAME 
ldfhread — read the file header of a common object file 


SYNOPSIS 


#include <stdio.h> 
#include <filehdr.h> 
#include <ldfcn.h> 


int Idfhread (Idptr, filehead) 
LDFILE *ldptr; 
FILHDR *filehead; 


DESCRIPTION 


ldfhread reads the file header of the common object file currently associated 
with Idptr into the area of memory beginning at filehead. 

ldfhread returns SUCCESS or FAILURE. Idfhread fails if it cannot read the 
file header. 


In most cases the use of Idfhread can be avoided by using the macro 
HEADER(Idptr) defined in Idfen.h (see Idfen(4)). fieldname of the file 
header may be accessed using HEADER (ldptr) .fieldname. 


The program must be loaded with the object file access routine library libld.a. 


SEE ALSO 
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ldclose(3X), Idopen(3X), ldfen(4) 
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NAME 
ldgetname — retrieve symbol name for common object file symbol table entry 


SYNOPSIS 
#include <stdio.h> 
#include <filehdr.h> 
#include <syms.h> 
#include <ldfcen.h> 
char *ldgetname (ldptr, symbol) 
LDFILE *ldptr; 
SYMENT *symbol; 

DESCRIPTION 
ldgetname returns a pointer to the name associated with symbol as a string. 
The string is contained in a static buffer local to ldgetname that is overwrit- 
ten by each call to ldgetname, and therefore must be copied by the caller if 
the name is to be saved. 
ldgetname can be used to retrieve names from object files without any back- 
ward compatibility problems. Idgetname will return NULL (defined in 
<stdio.h>) for an object file if the name cannot be retrieved. This situation 
can occur in the following cases: 


— ifthe “string table” cannot be found, 
— ifnot enough memory can be allocated for the string table, 


— ifthe string table appears not to be a string table (for example, if an auxili- 
ary entry is handed to Idgetname that looks like a reference to a name in 
a nonexistent string table), or 


— ifthe name’s offset into the string table is past the end of the string table. 


Typically, ldgetname is called immediately after a successful call to 
ldtbread to retrieve the name associated with the symbol table entry filled by 
ldtbread. 


The program must be loaded with the object file access routine library libld.a. 


SEE ALSO 
ldclose(3X), ldopen(3X), ldtbread(3X), ldtbseek(3X), ldfcn(4) 
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NAME 


ldlread, Idlinit, ldlitem — manipulate line number entries of a common object 
file function 


SYNOPSIS 


#include <stdio.h> 
#include <filehdr.h> 
#include <linenum.h> 
#include <ldfcn.h> 


int Idlread(Idptr, fenindx, linenum, linent) 
LDFILE *ldptr; 

long fenindx; 

unsigned short linenum; 

LINENO +*linent; 

int Idlinit(idptr, fenindx) 

LDFILE *ldptr; 

long fenindx; 

int ldlitem(1dptr, linenum, linent) 
LDFILE *ldptr; 

unsigned short linenum; 

LINENO ¢linent; 


DESCRIPTION 


Idlread searches the line number entries of the common object file currently 
associated with Idptr. Idlread begins its search with the line number entry 
for the beginning of a function and confines its search to the line numbers 
associated with a single function. The function is identified by fenindx, the 
index of its entry in the object file symbol table. Idlread reads the entry with 
the smallest line number equal to or greater than linenum into the memory 
beginning at linent. 

Idlinit and ldlitem together perform exactly the same function as ldlread. 
After an initial call to Idlread or Idlinit, ldlitem may be used to retrieve a 
series of line number entries associated with a single function. Idlinit simply 
locates the line number entries for the function identified by fenindx. Idli- 
tem finds and reads the entry with the smallest line number equal to or 
greater than linenum into the memory beginning at linent. 


ldlread, Idlinit, and ldlitem each return either SUCCESS or FAILURE. 
ldlread fails if there are no line number entries in the object file, if fenindx 
does not index a function entry in the symbol table, or if it finds no line num- 
ber equal to or greater than linenum. Idlinit fails if there are no line num- 
ber entries in the object file or if fenindx does not index a function entry in 
the symbol table. Idlitem fails if it finds no line number equal to or greater 
than linenum. 


The programs must be loaded with the object file access routine library 
libld.a. 


SEE ALSO 
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Idcloge(3X), Idopen(3X), ldtbindex(3X), ldfen(4) 
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NAME 


ldlseek, Idnlseek — seek to line number entries of a section of a common object 
file 


SYNOPSIS 


#include <stdio.h> 

#include <filehdr.h> 

#include <Idfcn.h> 

int ldlseek (Idptr, sectindx) 
LDFILE *ldptr; 

unsigned short sectindx; 

int Idnlseek (Idptr, sectname) 
LDFILE +«ldptr; 

char *sectname; 


DESCRIPTION 


ldlseek seeks to the line number entries of the section specified by sectindx 
of the common object file currently associated with Idptr. 


Idnlseek seeks to the line number entries of the section specified by 
sectname. 


Idlseek and Idnlseek return SUCCESS or FAILURE. Idlseek fails if sec- 
tindx is greater than the number of sections in the object file; ldnlseek fails 
if there is no section name corresponding with *sectname. Either function 
fails if the specified section has no line number entries or if it cannot seek to 
the specified line number entries. 


Note that the first section has an index of one. 
The program must be loaded with the object file access routine library libld.a. 


SEE ALSO 
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ldclose(3X), ldopen(3X), ldshread(3X), ldfen(4) 
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NAME 
ldohseek — seek to the optional file header of a common object file 
SYNOPSIS 
#include <stdio.h> 
#include <filehdr.h> 
#include <Idfcn.h> 
int ldohseek (Idptr) 
LDFILE *ldptr; 
DESCRIPTION 
Idohseek seeks to the optional file header of the common object file currently 
associated with Idptr. 
Idohseek returns SUCCESS or FAILURE. Idohseek fails if the object file has 
no optional header or if it cannot seek to the optional header. 


The program must be loaded with the object file access routine library libld.a. 


SEE ALSO 
Idclose(3X), Idopen(3X), ldfhread(3X), ldfen(4) 
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NAME 
ldopen, ldaopen — open a common object file for reading 
SYNOPSIS 


#include <stdio.h> 

#include <filehdr.h> 

#include <Ildfen.h> 

LDFILE *ldopen (filename, Idptr) 
char *filename; 

LDFILE *ldptr; 

LDFILE *Idaopen (filename, oldptr) 
char *filename; 

LDFILE *oldptr; 


DESCRIPTION 
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Idopen and Idclose(3X) are designed to provide uniform access to both 
simple object files and object files that are members of archive files. Thus an 
archive of common object files can be processed as if it were a series of simple 
common object files. 


If Idptr has the value NULL, then Idopen opens filename and allocates and 
initializes the LDFILE structure, and returns a pointer to the structure to the 
calling program. 


If ldptr is valid and if TYPE(Idptr) is the archive magic number, Idopen 
reinitializes the LDFILE structure for the next archive member of filename. 


Idopen and Idclose(3X) are designed to work in concert. Idclose returns 
FAILURE only when TYPE(Idptr) is the archive magic number and there is 
another file in the archive to be processed. Only then should Idopen be called 
with the current value of ldptr. In all other cases, in particular whenever a 
new filename is opened, Idopen should be called with a NULL ldptr argu- 
ment. 


The following is a prototype for the use of ldopen and Idclose(3X). 


/* for each filename to be processed */ 


ldptr = NULL; 
do 
{ 
if ( (ldptr = ldopen(filename, ldptr)) != NULL ) 
{ 
/* check magic number */ 
/* process the file */ 
} 
} while (ldclose(ldptr) == FAILURE ); 


If the value of oldptr is not NULL, Idaopen opens filename anew and allo- 
cates and initializes a new LDFILE structure, copying the TYPE, OFFSET, and 
HEADER fields from oldptr. Idaopen returns a pointer to the new LDFILE 
structure. This new pointer is independent of the old pointer, oldptr. The 
two pointers may be used concurrently to read separate parts of the object file. 
For example, one pointer may be used to step sequentially through the reloca- 
tion information, while the other is used to read indexed symbol table entries. 
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NULL if filename cannot be opened, or if memory for the LDFILE structure 
cannot be allocated. A successful open does not insure that the given file is a 
common object file or an archived object file. 


Both Idopen and Idaopen open filename for reading. Both functions return & 


The program must be loaded with the object file access routine library libld.a. 


SEE ALSO 
fopen(88S), Idclose(3X), ldfen(4) 
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@ NAME 


DYNIX/ptx LDRSEEK(3X) 


ldrseek, Idnrseek — seek to relocation entries of a section of a common object 
file 


SYNOPSIS 


#include <stdio.h> 

#include <filehdr.h> 

#include <Idfcn.h> 

int Idrseek (Idptr, sectindx) 
LDFILE *ldptr; 

unsigned short sectindx; 

int ldnrseek (Idptr, sectname) 
LDFILE *ldptr; 

char *sectname; 


DESCRIPTION 


ldrseek seeks to the relocation entries of the section specified by sectindx of 
the common object file currently associated with Idptr. 


ldnrseek seeks to the relocation entries of the section specified by sectname. 


Idrseek and Idnrseek return SUCCESS or FAILURE. Idrseek fails if sec- 
tindx is greater than the number of sections in the object file; ldnrseek fails 
if there is no section name corresponding with sectname. Either function 
fails if the specified section has no relocation entries or if it cannot seek to the 
specified relocation entries. 


Note that the first section has an index of one. 
The program must be loaded with the object file access routine library libld.a. 


SEE ALSO 
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ldclose(3X), lIdopen(3X), Idshread(3X), ldfen(4) 


DYNIX/ptx LDSHREAD (3X) 


NAME 
© ldshread, Idnshread — read an indexednamed section header of a common 
object file 


SYNOPSIS 
#include <stdio.h> 
#include <filehdr.h> 
#include <scnhdr.h> 
fiinclude <Idfcen.h> 


int ldshread (Idptr, sectindx, secthead) 
LDFILE +*ldptr; 
unsigned short sectindx; 
SCNHDR *secthead; 
int Idnshread (Idptr, sectname, secthead) 
LDFILE *ldptr; 
char *sectname; 
SCNHDR *secthead; 
DESCRIPTION 
Idshread reads the section header specified by sectindx of the common 
object file currently associated with Idptr into the area of memory beginning 
at secthead. 


ldnshread reads the section header specified by sectname into the area of 
memory beginning at secthead. 


& Idshread and Idnshread return SUCCESS or FAILURE. Idshread fails if 
sectindx is greater than the number of sections in the object file; ldnshread 
fails if there is no section name corresponding with sectname. Either func- 
tion fails if it cannot read the specified section header. 


Note that the first section header has an index of one. 
The program must be loaded with the object file access routine library libld.a. 


SEE ALSO 
Idclose(3X), ldopen(3X), ldfen(4) 


12/89 1 


DYNIX/ptx LDSSEEK(3X) 


NAME 


ldsseek, ]dnsseek — seek to an indexednamed section of a common object file 


SYNOPSIS 


#include <stdio.h> 

#include <filehdr.h> 

#include <ldfen.h> 

int Idsseek (Idptr, sectindx) 
LDFILE *ldptr; 

unsigned short sectindx; 

int Idnsseek (ldptr, sectname) 
LDFILE *Idptr; 

char *sectname; 


DESCRIPTION 


Idsseek seeks to the section specified by sectindx of the common object file 
currently associated with Idptr. 


Idnsseek seeks to the section specified by sectname. 


Idsseek and Idnsseek return SUCCESS or FAILURE. Idsseek fails if sec- 
tindx is greater than the number of sections in the object file; ldnsseek fails 
if there is no section name corresponding with sectname. Either function 
fails if there is no section data for the specified section or if it cannot seek to 
the specified section. 


Note that the first section has an index of one. 
The program must be loaded with the object file access routine library libld.a. 


SEE ALSO 
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ldclose(3X), 1dopen(3X), ldshread(3X), ldfen(4) 


DYNIX/ptx LDTBINDEX(3X) 


NAME 

ldtbindex — compute the index of a symbol table entry of a common object file 
SYNOPSIS 

#include <stdio.h> 

#include <filehdr.h> 

#include <syms.h> 

#include <Idfcn.h> 


long Idtbindex (Idptr) 
LDFILE *Idptr; 
DESCRIPTION 
Idtbindex returns the (long) index of the symbol table entry at the current 
position of the common object file associated with Idptr. 


The index returned by ldtbindex may be used in subsequent calls to 
Idtbread(3X). However, since Idtbindex returns the index of the symbol 
table entry that begins at the current position of the object file, if ldtbindex 
is called immediately after a particular symbol table entry has been read, it 
returns the index of the next entry. 


Idtbindex fails if there are no symbols in the object file, or if the object file is 
not positioned at the beginning of a symbol table entry. 


Note that the first symbol in the symbol table has an index of 0. 
The program must be loaded with the object file access routine library libld.a. 


SEE ALSO 
ldclose(3X), Idopen(3X), ldtbread(3X), ldtbseek(3X), ldfen(4) 


12/89 1 


DYNIX/ptx LDTBREAD(3X) 


NAME 


ldtbread — read an indexed symbol table entry of a common object file 


SYNOPSIS 


#include <stdio.h> 
#include <filehdr.h> 
#include <syms.h> 
#include <Idfcn.h> 


int ldtbread (Idptr, symindex, symbol) 
LDFILE *ldptr; 


long symindex; 
SYMENT *symbol; 


DESCRIPTION 


ldtbread reads the symbol table entry specified by symindex of the common 
object file currently associated with Idptr into the area of memory beginning 
at symbol. 

ldtbread returns SUCCESS or FAILURE. Idtbread fails if symindex is 
greater than or equal to the number of symbols in the object file, or ifit cannot 
read the specified symbol table entry. 


Note that the first symbol in the symbol table has an index of 0. 
The program must be loaded with the object file access routine library libld.a. 


SEE ALSO 
ldclose(3X), 1dopen(3X), ldtbseek(3X), ldgetname(3X), Idfen(4) 
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DYNIX/ptx LDTBSEEK(3X) 


NAME 

ldtbseek — seek to the symbol table of a common object file 
SYNOPSIS 

#include <stdio.h> 

#include <filehdr.h> 

#include <Idfcen.h> 


int ldtbseek (Idptr) 
LDFILE *ldptr; 


DESCRIPTION 
ldtbseek seeks to the symbol table of the common object file currently associ- 
ated with Idptr. 


ldtbseek returns SUCCESS or FAILURE. Idtbseek fails if the symbol table 
has been stripped from the object file, or if it cannot seek to the symbol table. 


The program must be loaded with the object file access routine library libid.a. 


SEE ALSO 
ldclose(3X), ldopen(3X), ldtbread(3X), ldfen(4) 
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NAME 
logname — return login name of user 


SYNOPSIS 
char *logname( ) 


DESCRIPTION 
logname returns a pointer to the null-terminated login name; it extracts the 
LOGNAME environment variable from the user’s environment. 


This routine is kept in /lib/libPW.a. 


FILES 
/etc/profile 


SEE ALSO 
env(1), login(1), getenv(3C), profile(4), environ(5) 


WARNINGS 
The return values point to static data whose content is overwritten by each 
call. 


This method of determining a login name is subject to forgery. 
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NAME 


malloc, free, realloc, calloc, mallopt, mallinfo — fast main memory allocator 


SYNOPSIS 


#include <malloc.h> 
char *malloc (size) 
unsigned size; 

void free (ptr) 

char *ptr; 

char *trealloc (ptr, size) 
char *ptr; 

unsigned size; 

char *calloc (nelem, elsize) 
unsigned nelem, elsize; 
int mallopt (cmd, value) 
int cmd, value; 


struct mallinfo mallinfo() 


DESCRIPTION 
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malloc and free provide a simple general-purpose memory allocation pack- 
age, which runs considerably faster than the malloc(3C) package. It is found 
in the library malloc, and is loaded if the option —Imalloc is used with cc(1) or 
1d(1). 


malloc returns a pointer to a block of at least size bytes suitably aligned for 
any use. 


The argument to free is a pointer to a block previously allocated by malloc; 
after free is performed this space is made available for further allocation, and 
its contents have been destroyed (but see mallopt below for a way to change 
this behavior). 


Undefined results will occur if the space assigned by malloc is overrun or if 
some random number is handed to free. 


realloc changes the size of the block pointed to by ptr to size bytes and 
returns a pointer to the (possibly moved) block. The contents will be 
unchanged up to the lesser of the new and old sizes. 


calloc allocates space for an array of nelem elements of size elsize. The 
space is initialized to zeros. 


mallopt provides for control over the allocation algorithm. The available val- 
ues for cmd are: 


M_MXFAST Set maxfast to value. The algorithm allocates all blocks 
below the size of maxfast in large groups and then doles them 
out very quickly. The default value for maxfast is 24. 


M_NLBLKS Set numlblks to value. The above mentioned “large groups” 
each contain numlblks blocks. numlblks must be greater 
than 0. The default value for numlblks is 100. 


M_GRAIN Set grain to value. The sizes of all blocks smaller than max- 
fast are considered to be rounded up to the nearest multiple of 
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grain. grain must be greater than 0. The default value of 
grain is the smallest number of bytes which will allow align- 
ment of any data type. Value will be rounded up to a multiple 
of the default when grain is set. 


M_KEEP Preserve data in a freed block until the next malloc, realloc, 
or calloc. This option is provided only for compatibility with 
the old version of malloc and is not recommended. 


These values are defined in the <malloc.h> header file. 
mallopt may be called repeatedly, but may not be called after the first small 


block is allocated. 
mallinfo provides instrumentation describing space usage. It returns the 
structure: 
struct mallinfo { 
int arena; /* total space in arena */ 
int ordblks; /* number of ordinary blocks */ 
int smblks; /* number of small blocks */ 
int hblkhd; /* space in holding block headers */ 
int hblks; /* number of holding blocks */ 
int usmblks; /* space in small blocks in use */ 
int fsmblks; /* space in free small blocks */ 
int uordblks; /* space in ordinary blocks in use */ 
int fordblks; /* space in free ordinary blocks */ 
int keepcost; /* space penalty if keep option */ & 
/* is used */ 


) 

This structure is defined in the <malloc.h> header file. 

Each of the allocation routines returns a pointer to space suitably aligned 
(after possible pointer coercion) for storage of any type of object. 


SEE ALSO 
brk(2), malloc(3C) 

DIAGNOSTICS 
malloc, realloc and calloc return a NULL pointer if there is not enough 
available memory. When realloc returns NULL, the block pointed to by ptr 
is left intact. If mallopt is called after any allocation or if cmd or value are 
invalid, non-zero is returned. Otherwise, it returns zero. 

WARNINGS 
This package usually uses more data space than malloc(3C). 


The code size is also bigger than malloc(3C). 


Note that unlike malloc(3C), this package does not preserve the contents of a 
block when it is freed, unless the M_KEEP option of mallopt is used. 


Undocumented features of malloc(3C) have not been duplicated. 
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DYNIX/ptx NDBM(3X) 


NAME 
dbm_open, dbm_close, dbm_fetch, dbm_store, dbm_delete, dbm_firstkey, 
dbm_nextkey, dbm_error, dbm_clearerr, dmb_blkflush — database subroutines 


SYNOPSIS 
#include <ndbm.h> 


typedef struct { 
char *dptr; 
int dsize; 
} datum; 
DBM *dbm_open(file, flags, mode) 
char *file; 
int flags, mode; 
void dbm_close(db) 
DBM *db; 
datum dbm_fetch(db, key) 
DBM *db; 
datum key; 
int dbm_store(db, key, content, flags) 
DBM *db; 
datum key, content; 
int flags; 


int dbm_delete(db, key) 
DBM *db; 
datum key; 
datum dbm_firstkey(db) 
DBM *db; 
datum dbm_nextkey(db) 
DBM *db; 
int dbm_error(db) 
DBM *db; 
int dbm_clearerr(db) 
DBM ‘*db; 
void dbm_blkflush(db) 
DBM *db; 
DESCRIPTION 
These functions maintain key/content pairs in a data base. The functions 
handle very large (a billion blocks) databases and access a keyed item in one 
or two file system accesses. This package replaces the earlier dbm(3x) library, 
which managed only a single database. 


key and content are described by the datum typedef. A datum specifies a 
string of dsize bytes pointed to by dptr. Arbitrary binary data, as well as nor- 
mal ASCII strings, are allowed. The data base is stored in two files. One file 
is a directory containing a bit map and has.dir as its suffix. The second file 
contains all data and has .pag as its suffix. 


12/89 1 


NDBM(3X) DYNIX/ptx 


Before a database can be accessed, it must be opened by dbm_open. This 
opens and/or creates the files file.dir and file.pag depending on the flags 
parameter (see open(2)). 


Once open, data stored under a key is accessed by dbm_fetch and data is 
placed under a key by dbm_store. The flags field can be either 
DBM_INSERT or DBM_REPLACE. DBM_INSERT only inserts new 
entries into the database and will not change an existing entry with the same 
key. DBM_REPLACE replaces an existing entry if it has the same key. A key 
(and its associated contents) is deleted by dbm_delete. A linear pass through 
all keys in a database may be made, in an (apparently) random order, by use of 
dbm_firstkey and dbm_nextkey. dbm_firstkey returns the first key in the 
database. dbm_nextkey returns the next key in the database. This code 
traverses the data base: 


for (key = dbm_firstkey (db); key.dptr != NULL; key = 
dbm_nextkey (db) ) 


dbm_error returns non-zero on an error in reading or writing the database. 
dbm_clearerr resets the error condition on the named database. 


If the same data base is being accessed by multiple programs (using some lock- 
ing scheme), the routine dbm_blkflush can be used to force a new read of 
internal buffers. This is necessary to insure that no other program has 
updated the data base and invalidated information stored in internal buffers. 


DIAGNOSTICS 
All functions that return an int indicate errors with negative values. A zero 
indicates no error. Routines that return a datum indicate errors with a null 
(0) dptr. If dbm_store called with a flags value of DBM_INSERT finds an 
existing entry with the same key it returns 1. 


NOTES 
These are Sequent library routines. Since these are Sequent extensions, code 
using these routines may not be portable to other systems. 


BUGS 
The .pag file contains holes so that its apparent size is about four times its 
actual content. Older systems may create real file blocks for these holes when 
touched. These files cannot be copied by normal means (cp, cat, tp, tar, ar) 
without filling in the holes. 


dptr pointers point into static storage that is changed by subsequent calls. 
This storage is not necessarily aligned; stored longs, for example, should be 
copied to a properly aligned block of memory before being accessed. 


The sum of the sizes of a key/content pair must not exceed the internal block 
size (currently 4096 bytes); and all key/content pairs that hash together must 
fit on a single block. dbm_store returns an error in the event that a disk 
block fills with inseparable data. 


dbm_delete does not physically reclaim file space, although it does make it 
available for reuse. 


The order of keys presented by dbm_firstkey and dbm_nextkey depends on 
a hashing function, not on anything interesting. 
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DYNIX/ptx NDBM(3X) 


NAME 
dbm_open, dbm_close, dbm_fetch, dbm_store, dbm_delete, dbm_firstkey, 
dbm_nextkey, dbm_error, dbm_clearerr, dmb_blkflush — database subroutines 


SYNOPSIS 
#include <ndbm.h> 


typedef struct { 
char *dptr; 
int dsize; 
} datum; 
DBM *dbm_open(file, flags, mode) 
char *file; 
int flags, mode; 
void dbm_close(db) 
DBM *db; 
datum dbm_fetch(db, key) 
DBM *db; 
datum key; 
int dbm_store(db, key, content, flags) 
DBM *db; 
datum key, content; 
int flags; 


int dbm_delete(db, key) 
DBM *db; 
datum key; 
datum dbm_firstkey(db) 
DBM *db; 
datum dbm_nextkey(db) 
DBM *db; 
int dbm_error(db) 
DBM *db; 
int dbm_clearerr(db) 
DBM *db; 
void dbm_blkflush(db) 
DBM *db; 
DESCRIPTION 
These functions maintain key/content pairs in a data base. The functions 
handle very large (a billion blocks) databases and access a keyed item in one 


or two file system accesses. This package replaces the earlier dbm(3x) library, 
which managed only a single database. 


key and content are described by the datum typedef. A datum specifies a 
string of dsize bytes pointed to by dptr. Arbitrary binary data, as well as nor- 
mal ASCII strings, are allowed. The data base is stored in two files. One file 
is a directory containing a bit map and has.dir as its suffix. The second file 
contains all data and has .pag as its suffix. 
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Before a database can be accessed, it must be opened by dbm_open. This 
opens and/or creates the files file.dir and file.pag depending on the flags 
parameter (see open(2)). 


Once open, data stored under a key is accessed by dbm_fetch and data is 
placed under a key by dbm_store. The flags field can be either 
DBM_INSERT or DBM_REPLACE. DBM_INSERT only inserts new 
entries into the database and will not change an existing entry with the same 
key. DBM_REPLACE replaces an existing entry if it has the same key. A key 
(and its associated contents) is deleted by dbm_delete. A linear pass through 
all keys in a database may be made, in an (apparently) random order, by use of 
dbm_firstkey and dbm_nextkey. dbm_firstkey returns the first key in the 
database. dbm_nextkey returns the next key in the database. This code 
traverses the data base: 


for (key = dbm_firstkey (db); key.dptr != NULL; key = 
dbm_nextkey (db) ) 


dbm_error returns non-zero on an error in reading or writing the database. 
dbm_clearerr resets the error condition on the named database. 


If the same data base is being accessed by multiple programs (using some lock- 
ing scheme), the routine dbm_blkflush can be used to force a new read of 
internal buffers. This is necessary to insure that no other program has 
updated the data base and invalidated information stored in internal buffers. 


DIAGNOSTICS 
All functions that return an int indicate errors with negative values. A zero 
indicates no error. Routines that return a datum indicate errors with a null 
(0) dptr. If dbm_store called with a flags value of DBM_INSERT finds an 
existing entry with the same key it returns 1. 


NOTES 
These are Sequent library routines. Since these are Sequent extensions, code 
using these routines may not be portable to other systems. 


BUGS 
The .pag file contains holes so that its apparent size is about four times its 
actual content. Older systems may create real file blocks for these holes when 
touched. These files cannot be copied by normal means (cp, cat, tp, tar, ar) 
without filling in the holes. 


dptr pointers point into static storage that is changed by subsequent calls. 
This storage is not necessarily aligned; stored longs, for example, should be 
copied to a properly aligned block of memory before being accessed. 


The sum of the sizes of a key/content pair must not exceed the internal block 
size (currently 4096 bytes); and all key/content pairs that hash together must 
fit on a single block. dbm_store returns an error in the event that a disk 
block fills with inseparable data. 


dbm_delete does not physically reclaim file space, although it does make it 
available for reuse. 


The order of keys presented by dbm_firstkey and dbm_nextkey depends on 
a hashing function, not on anything interesting. 
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NAME 


plot — graphics interface subroutines 


SYNOPSIS 


openpl () 

erase () 

label (s) 

char *s; 

line (x1, yl, x2, y2) 
int x1, yl, x2, y2; 
circle (x, y, r) 

int x, y, r5 

are (x, y, x0, yO, x1, y1) 
int x, y, x0, y0, xl, yl; 
move (x, y) 

int x, y; 

cont (x, y) 

int x, y; 

point (x, y) 

int x, y; 

linemod (s) 

char *8; 

space (x0, y0, x1, yl) 
int x0, yO, x1, yl; 
closepl () 


DESCRIPTION 


FILES 
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These subroutines generate graphic output in a relatively device-independent 
manner. space must be used before any of these functions to declare the 
amount of space necessary (see plot(4)). openpl must be used before any of 
the others to open the device for writing. closepl flushes the output. 


circle draws a circle of radius r with center at the point (x, y). 


arc draws an arc of a circle with center at the point (x, y) between the points 
(x0, yO) and (xl, y1). 


String arguments to label and linemod are terminated by nulls and do not 
contain new-lines. 


See plot(4) for a description of the effect of the remaining functions. 
The library files listed below provide several flavors of these routines. 


/usr/lib/libplot.a produces output for tplot(1G) filters 
/usr/lib/lib300.a for DASI 300 

Ausr/lib/lib300s.a for DASI 300s 

/usr/lib/lib450.a for DASI 450 
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/usr/lib/lib4014.a for TEKTRONIX 4014 

SEE ALSO S 
graph(1G), stat(1G), tplot(1G), plot(4) 

WARNINGS 


In order to compile a program containing these functions in file.c it is neces- 
sary touse cc file.c -lplot. 


In order to execute it, it is necessary to use a.out | tplot. 


The above routines use <stdio.h>, which causes them to increase the size of 
programs, not otherwise using standard I/O more than might be expected. 
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NAME 
> putspent — write shadow password file entry 


SYNOPSIS 
#include <shadow.h> 
int putspent (p, fp) 
struct spwd *p; 
FILE *fp; 

DESCRIPTION 
The putspent routine is the inverse of getspent(3X). Given a pointer toa 
spwd structure created by the getspent routine (or the getspnam routine), 
the putspent routine writes a line on the stream fp, which matches the for- 
mat of /etc/shadow. 


If the sp_min, sp_max, or sp_Istchg field of the spwd structure is —1, the 
corresponding /etc/shadow field is cleared. 

SEE ALSO 
getspent(3X). 


DIAGNOSTICS 
The putspent routine returns non-zero if an error was detected during its 
operation, otherwise zero. 


WARNINGS 
If a program not otherwise using standard I/O uses this routine, the size of the 
& program will increase more than might be expected. 


This routine is for internal use only, compatibility is not guaranteed. 
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NAME 


regemp, regex — compile and execute regular expression 


SYNOPSIS 


char *regemp (string! [, string2, ...], (char *)0) 
char *string1, *string2, ...; 


char *regex (re, subject[, ret0, ...]) 
char *re, *subject, +ret0, ...; 


extern char *__locl; 


DESCRIPTION 
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regemp compiles a regular expression (consisting of the concatenated argu- 
ments) and returns a pointer to the compiled form. malloc(3C) is used to cre- 
ate space for the compiled form. It is the user’s responsibility to free unneeded 
space so allocated. A NULL return from regemp indicates an incorrect argu- 
ment. regemp(1) has been written to generally preclude the need for this rou- 
tine at execution time. 


regex executes a compiled pattern against the subject string. Additional 
arguments are passed to receive values back. regex returns NULL on failure 
or a pointer to the next unmatched character on success. A global character 
pointer _locl points to where the match began. regemp and regex were 
mostly borrowed from the editor, ed(1); however, the syntax and semantics 
have been changed slightly. The following are the valid symbols and their 
associated meanings. 


[]*." These symbols retain their meaning in ed(1). 
$ Matches the end of the string; \n matches a new-line. 


- Within brackets the minus means through. For example, [a-z] is 
equivalent to [abcd ...xyz]. The — can appear as itself only if used as 
the first or last character. For example, the character class expres- 
sion [}-] matches the characters ] and -. 


+ A regular expression followed by + means one or more times. For 
example, [0-9]+ is equivalent to [0-9] [0-9]. 


{m} {m,} {m,u} 

Integer values enclosed in {} indicate the number of times the preced- 
ing regular expression is to be applied. The value m is the minimum 
number and u is a number, less than 256, which is the maximum. If 
only m is present (e.g., {m)}), it indicates the exact number of times 
the regular expression is to be applied. The value {m,} is analogous 
to {m,infinity}. The plus (+) and star (*) operations are equivalent to 
{1,} and {0,} respectively. 

(...)$ The value of the enclosed regular expression is to be returned. The 
value will be stored in the (n+1)th argument following the subject 
argument. At most ten enclosed regular expressions are allowed. 
regex makes its assignments unconditionally. 
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(...) | Parentheses are used for grouping. An operator, e.g., +, +, {}, can 
work on a single character or a regular expression enclosed in paren- 
theses. For example, (a* (cb+)*) $0. 


By necessity, all the above defined symbols are special. They must, therefore, 
be escaped with a \ (backslash) to be used as themselves. 


EXAMPLES 
Example 1: 


char *cursor, *newcursor, *ptr; 


newcursor = regex((ptr = regemp("“\n", (char *)0)), cursor); 
free(ptr); 
This example will match a leading new-line in the subject string pointed at by 
cursor. 
Example 2: 

char ret0O[9]; 

char *newcursor, *name; 


name = regcemp("([A-Za-~z] [A-za-z0-9 {0,7})$0", (char *)0); 
newcursor = regex(name, "012Testing345", ret0); 


This example will match through the string "Tezting3" and will return the 
address of the character after the last matched character (the 4). The string 
"Testing3" will be copied to the character array ret0. 


Example 3: 
#include "file.i" 
char *string, *newcursor; 


newcursor = regex(name, string); 


This example applies a precompiled regular expression in file.i [see 
regemp(1)] against string. 


These routines are kept in /lib/libPW.a. 


SEE ALSO 
ed(1), regemp(1), malloc(3C), regex(3x) 


BUGS 
The user program may run out of memory if regemp is called iteratively with- 
out freeing the vectors no longer required. 


2 12/89 


DYNIX/ptx SPUTL(3X) 


NAME 


sputl, sgetl — access long integer data in a machine-independent fashion 


SYNOPSIS 


void sputl (value, buffer) 
long value; 

char *buffer; 

long sgetl (buffer) 

char *buffer; 


DESCRIPTION 
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sputl takes the four bytes of the long integer value and places them in mem- 
ory starting at the address pointed to by buffer. The ordering of the bytes is 
the same across al] machines. 

sgetl retrieves the four bytes in memory starting at the address pointed to by 
buffer and returns the long integer value in the byte ordering of the host 
machine. 

The combination of sputl and sget! provides a machine-independent way of 
storing long numeric data in a file in binary form without conversion to char- 
acters. 

A program that uses these functions must be loaded with the object-file access 
routine library libld.a. 
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NAME 


ut_add_user, ut_delete_user — add/delete users in utmp file 


SYNOPSIS 


#include <utmp.h> 


struct utmp *ut_add_user (user, line, pid, host) 
char *user; 

char *line; 

int pid; 

char *host; 


struct utmp *ut_delete_user (line, pid, e_term, e_status) 
char *line; 

int pid; 

int e_term; 

int e_status; 


DESCRIPTION 


FILES 
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Programs that need to add or delete entries from the /etc/utmp file should go 
through these interfaces. 


Users may be added due to connections from remote machines (for example, 
rlogin), or windowing systems (for example, the X Window System). 


user is a user login name up to 8 characters. 


line is the user login line returned from the connection service. The leading 4 
characters of dev/ are not included, but the remainder of the path is used. 
This string must be no longer than 12 characters. 


pid is the process ID as returned from the getpid system call. 
host describes the origin of the login session; the four cases are as follows: 


A login from a hard-wired line must use a NULL character ((char *)0) 
as the host parameter. 


A remote login (through a network) must use the name of the host 
being logged in from as the host parameter. 


A windowing system using pseudoterminals via a network must use 
the window system display name as the host parameter. 


A windowing system using pseudoterminals via a hard-wired line 
must use the hard-wired line as the host parameter. 


The routine ut_add_user creates the utmp entry with type USER_PROCESS 
(see utmp.h). The routine ut_delete_user is used when a login session is com- 
pleted. It changes the utmp entry type to DEAD_PROCESS. ut_delete_user 
finds an entry based on line name or process ID. If the line name is not NULL, 
it is used to search the utmp file and locate the entry. If the line name is 
NULL, the process ID supplied is used to do the lookup. The parameter e_ter- 
mination should contain the lower 8 bits of the process exit status, and 
e_exit should contain the upper 8 bits of the process exit status. 


/etc/utmp 
/etc/wtmp 
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/etc/utmp_dbm.dir 
/etc/utmp_dbm.pag 

SEE ALSO 
getut(3C) 

DIAGNOSTICS 
On success, these routines return a pointer to the utmp structure placed in 
the utmp file. The pointer is normally be written to the wtmp file by the pro- 
gram invoking these routines. 


ANULL pointer is returned upon failure to read or write, regardless of 
whether the failure was because of permission or from another system failure. 


The routine ut_add_user may also return a NULL pointer in the event that 
the system login limit is reached. In this case a message stating that the login 
limit has been reached is printed on stdout. No entry is placed in /etc/utmp 
and the calling program should exit without establishing a login session. 


NOTES 
For enhanced performance reasons, Sequent uses a hashed utmp file. These 
routines are not part of standard System V and code that uses them may not 
be portable to other systems. 
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